Skip to content

awa-si/SAE

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 

Repository files navigation

SAE — State Aware Engine

SAE (State Aware Engine) is a cross-domain temporal intelligence framework for discovering, tracking, and reasoning about latent states and regimes in sequential data.
It is powered by NHSMM (Neural Hidden Semi-Markov Models) and designed to bridge research-grade sequence modeling with production-ready deployment.

SAE provides a unified engine for state inference, regime detection, and temporal decision support across heterogeneous, non-stationary time series.


Key Capabilities

  • Explicit Latent State Modeling
    Models hidden regimes with variable, learnable state durations, enabling accurate dwell-time reasoning beyond standard HMMs.

  • Context-Aware Dynamics
    Initial states, transitions, durations, and emissions can be modulated by external covariates, supporting non-stationary and adaptive behavior.

  • Neural + Probabilistic Hybrid
    Combines classical HSMM structure with neural parameterization, preserving interpretability while increasing expressiveness.

  • Exact and Approximate Inference
    Supports forward-backward likelihoods, Viterbi decoding, and differentiable training for neuralized latent states.

  • Production-Oriented Design
    GPU-ready, batched, modular, and suitable for cloud, on-prem, or edge deployment.


Relationship to NHSMM

  • NHSMM
    A modular PyTorch library implementing neural, context-aware Hidden Semi-Markov Models, fully open-source.

  • SAE
    A system-level engine built on NHSMM, providing:

    • domain adapters
    • inference pipelines
    • deployment patterns
    • cross-domain abstractions

SAE treats NHSMM as its latent state inference backbone.


Core Use Cases

  • Finance & Trading — Market regime detection, volatility states, adaptive strategy modeling.
  • Cybersecurity & Systems Monitoring — Hidden operational states, anomaly detection, behavior shifts in logs or telemetry.
  • IoT & Industrial Analytics — Predictive maintenance, machine state monitoring, fault regime discovery.
  • Health & Wearables — Activity segmentation, physiological state tracking, anomaly detection.
  • Robotics & Autonomous Systems — Behavior monitoring, task phase detection, safety-critical state transitions.
  • General Temporal AI Research — Neural HSMMs, hybrid probabilistic models, non-stationary sequence learning.

Deployment Modes (Planned / In Progress)

  • Cloud / SaaS — Scalable, multi-tenant temporal analytics.
  • On-Prem / Edge — Low-latency, privacy-preserving inference close to data sources.
  • Accelerator-Ready — GPU-first execution with future support for additional backends.

Status

⚠️ Alpha / Early Development

SAE is under active development.
APIs, abstractions, and deployment tooling may change before 1.0.0.


Getting Started

SAE currently relies on NHSMM as its core dependency:

pip install nhsmm
Higher-level SAE components, adapters, and services will be released incrementally.
Early-access versions and research previews are available via Patreon or subscription for controlled use.

Licensing

SAE is released under a Proprietary License © 2026 AWA.SI.

The repository is public, but usage is restricted:

Viewing, cloning, and personal experimentation are permitted.

Redistribution, commercial use, or deployment without permission is prohibited.

Early-access releases may be provided to subscribers via Patreon, with copy usage governed by this Proprietary License.

For full license terms, see LICENSE.

NHSMM remains fully open-source (Apache 2.0), and can be used independently.

Support This Project

Development and research around SAE and NHSMM are supported via:

Patreon (early-access, research sketches, pre-releases)

GitHub Sponsors

Medium articles & research notes

See FUNDING.md for details on how contributions help sustain development.

About

State Aware Engine (SAE) is a cross-domain temporal intelligence framework built on NHSMM, designed to infer, track, and reason about latent states and regimes in sequential data.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors