🦅 FluxState Edge SDK

Privacy-Preserving Contextual Edge Video Analytics for Enterprise Security

FluxState Edge is an extensible, camera-agnostic video analytics SDK designed for direct integration into proprietary security backends. It processes RTSP streams locally on the edge, extracting behavioral metadata via object detection, 3D skeletal posing, audio processing, and VLM semantic reasoning with our v1.1 Adaptive Intelligence layer.

🚀 Quick Install

pip install fluxstate-security

🎥 Installation Demo

See the SDK installation and verification in under a minute.

▶️ Watch Installation Demo (Google Drive)

⚡ System Capabilities

🖼️ Architectural Vision & Use Cases

Sub-Pipelines

🛠️ Minimal SDK Integration

FluxState is designed to fade into the background. Drop it into your existing backend and attach a webhook.

import time
from fluxstate_security import FluxStateNode

# 1. Initialize the SDK
sdk = FluxStateNode()

# 2. Define your integration hook
def handle_threat(event_payload):
    print(f"\n[INTEGRATION BUS] Escalating to VMS...")
    print(f"Target Identity: {event_payload['entities']}")
    print(f"Behavioral Vector: {event_payload['context_log']}")
    print(f"Feedback Event ID: {event_payload.get('event_id', 'None')}")

# 3. Bind the hook
sdk.on_threat_detected = handle_threat

# 4. Deploy Headlessly (Runs as a background daemon)
sdk.start_headless_daemon()
sdk.start_api_server(port=8000) # Starts the JSON API & Feedback loop

try:
    while True: time.sleep(1)
except KeyboardInterrupt:
    sdk.stop() # 5. Clean shutdown

📦 Deployment Strategies

docker build -t fluxstate-security .
docker run -d --name fluxstate-security fluxstate-security

pip install fluxstate-security

# macOS dependencies
brew install tesseract portaudio

# Linux dependencies
sudo apt-get install tesseract-ocr libportaudio2 libportaudiocpp0 portaudio19-dev

🧪 Forensics & Testing

FluxState ships with an automated pytest suite covering the Forensic SQLite ledger, semantic retrievers, and JSON intelligence policies.

pytest tests/

📡 API Reference

POST /api/v2/feedback

Submit operator feedback to adapt the system. Payload:

{
  "event_id": "uuid-string",
  "human_label": "FALSE_POSITIVE",
  "operator_id": "guard-123",
  "operator_role": "admin"
}