Skip to content

AsieduDevelopmentHub/SentraCore

Repository files navigation

SentraCore

SentraCore is a local system behavior intelligence platform for Windows that continuously analyzes system telemetry to understand performance behavior, detect anomalies, explain system slowdowns, and estimate future resource pressure before it impacts usability.

Unlike traditional monitoring tools that focus on raw snapshots, SentraCore interprets system behavior over time β€” helping users understand what is happening, why it is happening, and how it may affect overall system responsiveness.


Current Status

SentraCore currently includes:

  • Real-time telemetry monitoring
  • Behavioral baseline learning
  • Statistical anomaly detection
  • Root cause analysis
  • Predictive risk estimation
  • Historical monitoring (Logbook)
  • Flutter desktop dashboard
  • Windows installer and packaging system

Core Features

System Stability Index

Unified system health scoring based on:

  • resource pressure
  • anomaly deviation
  • sustained stress trends
  • predictive degradation risk

Behavioral Intelligence

Learns normal system behavior per machine, including:

  • CPU usage patterns
  • memory behavior
  • disk activity trends
  • time-of-day workload patterns

Root Cause Analysis

Analyzes:

  • process activity
  • resource contention
  • event timing
  • system degradation patterns

Provides ranked likely contributors instead of raw metrics alone.


Predictive Forecasting

Estimates future resource exhaustion using trend analysis:

  • memory saturation forecasting
  • CPU trend projection
  • disk pressure estimation
  • ETA-style degradation warnings

Historical Monitoring

Automatically records and visualizes:

  • CPU pressure
  • memory pressure
  • disk pressure
  • long-term behavior trends

Alerts & Diagnostics

Includes:

  • live alerts
  • alert history
  • diagnostics timeline
  • Windows notifications
  • root cause summaries

Architecture

Flutter Dashboard
        ↕ WebSocket / REST API
Python Intelligence Engine
    β”œβ”€β”€ Telemetry Collection
    β”œβ”€β”€ Baseline Learning
    β”œβ”€β”€ Anomaly Detection
    β”œβ”€β”€ Correlation Engine
    β”œβ”€β”€ Prediction Engine
    └── Alert System

Technology Stack

Layer Technology
Engine Python 3.11, psutil
API FastAPI, WebSockets
Dashboard Flutter Desktop
Packaging PyInstaller, Inno Setup
CI/CD GitHub Actions

Getting Started

Development

See the setup documentation below for full instructions.

# Start engine
.venv\Scripts\python -m engine.main

# Run dashboard
cd dashboard
flutter run -d windows

Installer

Download the latest installer from the Releases page.

The installer:

  • installs SentraCore
  • creates shortcuts
  • configures optional startup launch
  • sets up the monitoring engine automatically

Documentation

Document Description
Development Setup Full local development setup
Engine Setup Engine configuration and setup
Dashboard Setup Flutter dashboard setup
Intelligence Pipeline Internal intelligence architecture
Building SentraCore Packaging and installer process

Philosophy

SentraCore is built around five principles:

  1. Observation
  2. Behavioral Modeling
  3. Anomaly Detection
  4. Correlation Analysis
  5. Predictive Awareness

License

Apache License 2.0

About

SentraCore is a local system behavior intelligence layer that analyzes time-based system telemetry to detect performance degradation patterns, estimate user impact, and provide explainable root-cause insights with safe optimization recommendations.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors