🧠 ZEUS — Cognitive Operating System & Neural Interface

ZEUS is a modular, high-performance cognitive system designed to bridge human intent and machine execution. It integrates advanced LLMs, real-time vision, streaming voice synthesis, and autonomous system monitoring into a unified, neural-responsive command center.

---

🌌 System Vision

ZEUS is not just an assistant; it is a Neural Interface that decentralizes intelligence across your workspace. By combining high-speed Rust backends with the cognitive flexibility of Gemini and Ollama, ZEUS creates a persistent, evolving digital presence.

---

🏗️ Synaptic Architecture

The system operates through a polyglot orchestration layer, ensuring low-latency responses and robust memory retention.

High-Level Flow

graph TD
    User((User)) <--> Mobile[Flutter HUD]
    User <--> Web[Web Command Center]
    
    subgraph Core[ZEUS CORE]
        API[FastAPI Backend]
        LLM[Cognitive Engine - Gemini/Ollama]
        Memory[(Synaptic Memory - SQLite/Vector)]
        Watcher[Rust File Watcher]
    end
    
    Mobile <-->|WS/JWT| API
    Web <-->|Socket.IO| API
    API <--> LLM
    API <--> Memory
    Watcher -->|Events| API

Loading

Cognitive Pipeline

sequenceDiagram
    participant U as User
    participant H as Mobile/Web HUD
    participant B as Backend (FastAPI)
    participant C as Cognitive Core (LLM)
    participant M as Synaptic Memory

    U->>H: Interaction (Voice/Text/Event)
    H->>B: Encrypted Payload (JWT)
    B->>M: Context Retrieval (RAG)
    M-->>B: Relevant Memories
    B->>C: Augmented Prompt
    C-->>B: Streaming Response
    B->>H: Real-time Update
    B->>M: Consolidate Memory

Loading

---

🚀 Key Capabilities

• 🎙️ Neural Voice Pipeline: Sentence-by-sentence streaming for near-zero latency interaction.
• 👁️ Vision & Context Awareness: Real-time analysis of screen, web, and local file states.
• 🦀 Rust-Powered Sensors: High-performance filesystem monitoring via watcher_rs for instant event detection.
• 📱 Mobile HUD: A Flutter-based extension providing a visual, responsive interface to the system's neural state.
• 🧠 Advanced Memory: Hybrid Relational (SQLite) and Vector (JSON/Embeddings) memory hierarchy.

---

🛠️ Technical Stack

• Backend: Python 3.10+ (FastAPI, Socket.IO)
• Cognitive: Gemini Pro API / Ollama (Local Fallback)
• Performance: Rust (System Monitoring & Resource Intensive Tasks)
• Frontend:
  • Web: Vanilla JS / HTML5 (Modern HUD Design)
  • Mobile: Flutter (Dart)
• Infrastructure: WebSocket-based real-time synchronization with JWT security.

---

🏁 Getting Started

1. Synchronization

Clone the repository and initialize the environment:

git clone https://github.com/geniusdev-tech/zeusOS.git
cd zeusOS
./bin/setup  # Optional setup script if available

2. Environment Configuration

Create a .env file based on .env.example:

GEMINI_API_KEY=your_key_here
ZEUS_MOBILE_TOKEN=secure_token_here
ALLOW_LAN=true

3. Execution

Launch the core modules using the unified binary:

chmod +x bin/zeus
./bin/zeus web      # Launch Web Command Center
./bin/zeus watcher  # Launch Rust File Sensor

---

📱 Mobile Deployment

The ZEUS Mobile HUD is located in zeus_extension/.

1. Ensure Flutter is installed.
2. Run flutter build apk --release or install the pre-compiled zeus_extension_v1.1.apk.

---

📜 Repository Structure

• apps/: Main entry points and service orchestrators.
• zeus_core/: Cognitive logic, memory managers, and agent strategies.
• watcher_rs/: High-performance Rust file monitoring.
• zeus_extension/: Flutter mobile application.
• docs/: Technical specifications and system analysis.

---

Tip

Use the bin/zeus command-line utility for the most streamlined experience across all system components.

---

ZEUS — The ultimate interface between human intelligence and machine cognition.