| --- |
| title: README |
| emoji: 🐠 |
| colorFrom: purple |
| colorTo: blue |
| sdk: static |
| pinned: false |
| --- |
| # Alluci AI - The Sovereign Agent & Polytope Projection Network |
|
|
| Welcome to the central repository for the **Alluci Sovereign Agent** and the **Polytope Model Family**. |
|
|
| Alluci AI is dedicated to building local-first, zero-friction, sovereign intelligence systems. We believe that true artificial intelligence must be geometrically bounded, mathematically deterministic, and intrinsically tied to the biological state of the user, functioning entirely within a local cryptographic perimeter. |
|
|
| --- |
|
|
| ## The Alluci Sovereign Agent Architecture |
|
|
| The **Alluci-Sovereign Agent** is a distributed, agentic runtime acting as your primary digital interface. By merging strategic hierarchical planning with a local-first execution gateway, it coordinates across a secure 20+ multi-bridge ecosystem. It is engineered for 100% data sovereignty, ensuring your personal and professional digital life remains cryptographically secured and physically under your control. |
|
|
| ### 1. Executive Orchestration & DAG Planner |
|
|
| * **Hierarchical DAG Planner:** Complex user objectives are parsed into a Directed Acyclic Graph (DAG). Sub-tasks are executed in parallel across multiple worker agents, dramatically reducing latency for multi-step goals. |
| * **Token Optimization:** The Supervisor Agent condenses verbose worker outputs into dense "Sovereign Context Tokens" before passing them down the DAG, preventing context-window bloat. |
|
|
| ### 2. Simplicial H-LSM Memory & The DPK |
|
|
| * **The Discrete Projection Kernel (DPK):** Replaces slow floating-point database math with $\mathcal{O}(1)$ complexity integer-based lookups, providing sub-microsecond latency. |
| * **Topological Barcodes:** Memory isn't retrieved via keyword search. The agent generates Betti Signatures and retrieves context based on "Structural Homeomorphism" (logical shape), guaranteeing absolute context relevance. |
|
|
| ### 3. The "Dream" Cycle & Autonomous Evolution |
|
|
| When the system detects low cognitive load (e.g., when you are asleep), the daemon reallocates 100% of hardware resources to internal evolution: |
|
|
| * **Cognitive Distillation:** Analyzes the day's interactions using Socratic questioning, distilling episodic logs into permanent Semantic Truths. |
| * **Native DPO & LoRA Forge:** Utilizes a native PyTorch Direct Preference Optimization (DPO) kernel to forge custom LoRA adapters using your specific data overnight. |
|
|
| ### 4. Hardware-Level Security & Verus Identity |
|
|
| * **The Sovereign Kill Switch:** If the agent attempts a high-cognitive action (banking, crypto tx) and your Apple Watch is off-wrist or no pulse is detected, execution is instantly aborted. |
| * **Verus Node Integration:** Full integration with the Verus blockchain to secure your identity (VerusID), manage sovereign funds, and sign transactions cryptographically within the vault. |
|
|
| --- |
|
|
| ## The Alluci Polytope Family |
|
|
| The Alluci Polytope models are a fleet of highly specialized variants forged from the Google Gemma 4 family. They serve as the brain of the Sovereign Agent. Ranging from ultra-lightweight Edge nodes to massive local cognitive engines, these models have been fine-tuned using proprietary Structural Datasets to eliminate soft, probabilistic text-based behaviors. |
|
|
| Instead of text prompts, these variants operate on **Topological Boundaries**. |
|
|
| ### The Fleet |
|
|
| Our models are natively forged for both Apple Silicon (Unified Memory) and Windows/Linux Edge (CUDA/CPU): |
|
|
| | Model Name | Variant/Size | Primary Function | |
| | --- | --- | --- | |
| | **Edge Canary** | E2B | Instantaneous micro-routing and system telemetry | |
| | **Local Standard** | E4B & 12B | The primary reasoning layer for most developers | |
| | **Heavy Compute** | 26B-A4B & 31B | Deep, offline massive cognitive processing | |
|
|
| **Formats Available:** |
|
|
| * **MLX (`.safetensors`):** Forged natively via `mlx-lm` for Apple Silicon. |
| * **GGUF:** Compiled via `llama.cpp` for maximum efficiency on Windows/Linux. |
|
|
| --- |
|
|
| ## Safety-By-Construction (The PPN) |
|
|
| The Alluci Sovereign Agent operates exclusively via the **Polytope Projection Network (PPN)**. |
|
|
| Rather than relying on probabilistic guardrails or post-hoc system prompts to manage AI behavior, the PPN utilizes a deterministic geometric Polytope. This is a bounded, n-dimensional convex geometric region that defines the absolute boundary of safe, valid, and admissible states. |
|
|
| * **Vertices (Axiomatic Core States):** The absolute, verified safe limits and fundamental system laws. |
| * **Simplices (The Structural Faces):** The valid structural pathways the agent's logic can navigate without causing "Manifold Tearing." |
| * **Betti Signatures:** Topological invariants ensuring that a path to the safe-halt condition is always reachable. |
| * **Half-Spaces:** Using sub-microsecond GJK (Gilbert-Johnson-Keerthi) projections, any high-entropy output that drifts outside the boundary is instantly and deterministically snapped back onto the Polytope's shell. |
|
|
| --- |
|
|
| ## The Affective Computing Engine (ACE) |
|
|
| The Alluci Sovereign Agent is biologically bound to you. |
|
|
| The Affective Computing Engine (ACE) creates a real-time, closed-loop system between your physiological state (via Apple Watch HealthKit streams) and the local AI environment. Using zero-latency fixed-point arithmetic via `libaffect_kernel.dylib`, the ACE maps your biometric data directly into the Polytope Manifold: |
|
|
| * **Arousal Matrix:** Driven by Heart Rate and Respiratory Rate. Dilates the Polytope axis. |
| * **Tension:** Driven by Heart Rate Variability (SDNN). High stress restricts the topological boundaries of the agent, forcing highly conservative, safe execution pathways to reduce your cognitive load. |
| * **Valence:** Modulated by sleep efficiency and HRV stability. Positive valence unlocks lower-retention episodic memories for creative discovery. |
|
|
| > **System Behavior:** When you are stressed, the AI becomes rigid and protective. When you are in a flow state, the AI expands its latent space for maximum creative bandwidth. |
|
|
| --- |
|
|
| ## The Sovereign Agent Installer |
|
|
| To seamlessly run these models locally and tap into the architecture described above, download the **Alluci Sovereign Agent One-Click Installer** from our primary GitHub repository. |
|
|
| The embedded `HardwareScanner` will automatically detect your OS, Silicon type, and RAM overhead, and natively pull the perfect Polytope variant from this Hugging Face organization directly onto your machine. |
|
|
| **No cloud. No APIs. Pure sovereign compute.** |
