fluxstate-security 1.0.0__tar.gz

fluxstate_security-1.0.0/PKG-INFO

@@ -0,0 +1,162 @@
+Metadata-Version: 2.4
+Name: fluxstate-security
+Version: 1.0.0
+Summary: Privacy-Preserving Contextual Edge Video Analytics SDK
+Author: FluxState Security Architecture
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Description-Content-Type: text/markdown
+Requires-Dist: opencv-python>=4.8.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: mediapipe>=0.10.0
+Requires-Dist: ultralytics>=8.0.0
+Requires-Dist: pytesseract>=0.3.10
+Requires-Dist: pyaudio>=0.2.14
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: summary
+
+<div align="center">
+
+<img src="assets/fluxstate_herobanner.png" alt="FluxState Edge Hero Banner" width="100%">
+
+# 🦅 FluxState Edge SDK
+
+**Privacy-Preserving Contextual Edge Video Analytics for Enterprise Security**
+
+[![PyPI version](https://img.shields.io/pypi/v/fluxstate-security.svg?style=for-the-badge&color=2e2e2e)](https://pypi.org/project/fluxstate-security/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge&color=2e2e2e)](https://opensource.org/licenses/MIT)
+[![Tests: Passing](https://img.shields.io/badge/Tests-Passing-brightgreen.svg?style=for-the-badge&color=2e2e2e)]()
+
+<br>
+
+*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.
+
+</div>
+
+---
+
+<br>
+
+## 🚀 Quick Install
+
+```bash
+pip install fluxstate-security
+```
+
+## 🎥 Installation Demo
+
+See the SDK installation and verification in under a minute.
+
+▶️ [Watch Installation Demo (Google Drive)](https://drive.google.com/file/d/1wf4hSMkGXe3q5MOipx87nfwzQis2_Xcf/view?usp=sharing)
+
+<br>
+
+## ⚡ System Capabilities
+
+| Capability | Technical Implementation |
+| :--- | :--- |
+| 🧠 **Agentic VLM Reasoner** | Runs Vision-Language Models (e.g., `Qwen2.5-VL`) locally via MLX on Apple Silicon unified memory for deep contextual scene understanding. Bypasses cloud APIs entirely. |
+| 🎯 **Tactical Visual Grounding** | Automatically injects high-contrast red bounding boxes over anomalies. This guides the VLM toward the detected region, reducing irrelevant reasoning and improving contextual grounding. |
+| 🛡️ **Privacy-by-Design** | Actively zeroes out image buffers post-inference via C-level `memset`. Designed with privacy-first principles to prevent sensitive pixel data from lingering in the system heap. |
+| 🗄️ **Temporal Forensics** | Behavioral anomalies are serialized into a local SQLite database (`fluxstate_security/core/forensics.py`), creating a searchable text-based ledger of physical events. |
+| 📹 **Hardware Agnostic** | Ingests existing IP cameras via standard RTSP URLs. No proprietary recording hardware required. |
+| 🐳 **Edge Containerization** | Ships with a highly optimized `Dockerfile` for enterprise edge deployments (Kubernetes/Docker Swarm), permanently locking native OS dependencies. |
+
+<br>
+
+## 🖼️ Architectural Vision & Use Cases
+
+<div align="center">
+  <img src="assets/fluxstate_architectural_diagram.png" alt="FluxState Architecture Diagram" width="90%">
+  <br><br>
+  <img src="assets/fluxstate_usecases.png" alt="Use Cases" width="90%">
+</div>
+
+<br>
+
+## 🛠️ Minimal SDK Integration
+
+FluxState is designed to fade into the background. Drop it into your existing backend and attach a webhook.
+
+```python
+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']}")
+
+# 3. Bind the hook
+sdk.on_threat_detected = handle_threat
+
+# 4. Deploy Headlessly (Runs as a background daemon)
+sdk.start_headless_daemon()
+
+try:
+    while True: time.sleep(1)
+except KeyboardInterrupt:
+    sdk.stop() # 5. Clean shutdown
+```
+
+<br>
+
+## 📦 Deployment Strategies
+
+<details>
+<summary><b>Option A: Enterprise Docker Deployment (Recommended)</b></summary>
+<br>
+For production environments, use the provided Docker container to guarantee system dependencies (Tesseract, PortAudio) are perfectly locked across the cluster.
+
+```bash
+docker build -t fluxstate-security .
+docker run -d --name fluxstate-security fluxstate-security
+```
+</details>
+
+<details>
+<summary><b>Option B: Local Python Development</b></summary>
+<br>
+
+```bash
+pip install fluxstate-security
+
+# macOS dependencies
+brew install tesseract portaudio
+
+# Linux dependencies
+sudo apt-get install tesseract-ocr libportaudio2 libportaudiocpp0 portaudio19-dev
+```
+</details>
+
+<br>
+
+## 🧪 Forensics & Testing
+FluxState ships with an automated `pytest` suite covering the Forensic SQLite ledger and JSON intelligence policies.
+```bash
+pytest tests/
+```
+
+---
+
+<div align="center">
+  <i>For a deeper dive into the threading model, VLM orchestration, and the SQLite schema, see <a href="architecture.md">architecture.md</a>.</i>
+</div>
+
+---
+
+<div align="center">
+  <b>📦 <a href="https://pypi.org/project/fluxstate-security/">PyPI Package</a></b> • 
+  <b>📖 <a href="architecture.md">Documentation</a></b>
+</div>

fluxstate_security-1.0.0/README.md

@@ -0,0 +1,138 @@
+<div align="center">
+
+<img src="assets/fluxstate_herobanner.png" alt="FluxState Edge Hero Banner" width="100%">
+
+# 🦅 FluxState Edge SDK
+
+**Privacy-Preserving Contextual Edge Video Analytics for Enterprise Security**
+
+[![PyPI version](https://img.shields.io/pypi/v/fluxstate-security.svg?style=for-the-badge&color=2e2e2e)](https://pypi.org/project/fluxstate-security/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge&color=2e2e2e)](https://opensource.org/licenses/MIT)
+[![Tests: Passing](https://img.shields.io/badge/Tests-Passing-brightgreen.svg?style=for-the-badge&color=2e2e2e)]()
+
+<br>
+
+*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.
+
+</div>
+
+---
+
+<br>
+
+## 🚀 Quick Install
+
+```bash
+pip install fluxstate-security
+```
+
+## 🎥 Installation Demo
+
+See the SDK installation and verification in under a minute.
+
+▶️ [Watch Installation Demo (Google Drive)](https://drive.google.com/file/d/1wf4hSMkGXe3q5MOipx87nfwzQis2_Xcf/view?usp=sharing)
+
+<br>
+
+## ⚡ System Capabilities
+
+| Capability | Technical Implementation |
+| :--- | :--- |
+| 🧠 **Agentic VLM Reasoner** | Runs Vision-Language Models (e.g., `Qwen2.5-VL`) locally via MLX on Apple Silicon unified memory for deep contextual scene understanding. Bypasses cloud APIs entirely. |
+| 🎯 **Tactical Visual Grounding** | Automatically injects high-contrast red bounding boxes over anomalies. This guides the VLM toward the detected region, reducing irrelevant reasoning and improving contextual grounding. |
+| 🛡️ **Privacy-by-Design** | Actively zeroes out image buffers post-inference via C-level `memset`. Designed with privacy-first principles to prevent sensitive pixel data from lingering in the system heap. |
+| 🗄️ **Temporal Forensics** | Behavioral anomalies are serialized into a local SQLite database (`fluxstate_security/core/forensics.py`), creating a searchable text-based ledger of physical events. |
+| 📹 **Hardware Agnostic** | Ingests existing IP cameras via standard RTSP URLs. No proprietary recording hardware required. |
+| 🐳 **Edge Containerization** | Ships with a highly optimized `Dockerfile` for enterprise edge deployments (Kubernetes/Docker Swarm), permanently locking native OS dependencies. |
+
+<br>
+
+## 🖼️ Architectural Vision & Use Cases
+
+<div align="center">
+  <img src="assets/fluxstate_architectural_diagram.png" alt="FluxState Architecture Diagram" width="90%">
+  <br><br>
+  <img src="assets/fluxstate_usecases.png" alt="Use Cases" width="90%">
+</div>
+
+<br>
+
+## 🛠️ Minimal SDK Integration
+
+FluxState is designed to fade into the background. Drop it into your existing backend and attach a webhook.
+
+```python
+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']}")
+
+# 3. Bind the hook
+sdk.on_threat_detected = handle_threat
+
+# 4. Deploy Headlessly (Runs as a background daemon)
+sdk.start_headless_daemon()
+
+try:
+    while True: time.sleep(1)
+except KeyboardInterrupt:
+    sdk.stop() # 5. Clean shutdown
+```
+
+<br>
+
+## 📦 Deployment Strategies
+
+<details>
+<summary><b>Option A: Enterprise Docker Deployment (Recommended)</b></summary>
+<br>
+For production environments, use the provided Docker container to guarantee system dependencies (Tesseract, PortAudio) are perfectly locked across the cluster.
+
+```bash
+docker build -t fluxstate-security .
+docker run -d --name fluxstate-security fluxstate-security
+```
+</details>
+
+<details>
+<summary><b>Option B: Local Python Development</b></summary>
+<br>
+
+```bash
+pip install fluxstate-security
+
+# macOS dependencies
+brew install tesseract portaudio
+
+# Linux dependencies
+sudo apt-get install tesseract-ocr libportaudio2 libportaudiocpp0 portaudio19-dev
+```
+</details>
+
+<br>
+
+## 🧪 Forensics & Testing
+FluxState ships with an automated `pytest` suite covering the Forensic SQLite ledger and JSON intelligence policies.
+```bash
+pytest tests/
+```
+
+---
+
+<div align="center">
+  <i>For a deeper dive into the threading model, VLM orchestration, and the SQLite schema, see <a href="architecture.md">architecture.md</a>.</i>
+</div>
+
+---
+
+<div align="center">
+  <b>📦 <a href="https://pypi.org/project/fluxstate-security/">PyPI Package</a></b> • 
+  <b>📖 <a href="architecture.md">Documentation</a></b>
+</div>

fluxstate_security-1.0.0/fluxstate_security/__init__.py

@@ -0,0 +1,3 @@
+from .app import FluxStateNode
+
+__all__ = ["FluxStateNode"]