Description: Local-first Agent OS with 18 LLM providers, 18 channels, 130+ MCP tools, 6-tier cognitive memory, 4-channel hybrid search, Flutter Command Center UI, cross-platform social listening, hierarchical document reasoning, and enterprise security. 13,000+ tests, 89% coverage.

v0.90.0 — Cross-Platform Social Listening + Hierarchical Retrieval + CAG Layer

# COGNITHOR · Agent OS

Local-first, autonomous agent operating system for personal AI assistance.

Cognition + Thor — Intelligence with Power

★ View on GitHub ↓ Download v0.90.0
18
LLM Providers
18
Channels
130+
MCP Tools
13,000+
Tests
89%
Coverage
33+
Databases

## Core Capabilities

Everything an autonomous agent needs, running entirely on your machine.

🧠

### 18 LLM Providers

Ollama, LM Studio, vLLM, llama-cpp-python (local), OpenAI, Anthropic, Gemini, Groq, DeepSeek, Mistral, Together, OpenRouter, xAI, Cerebras, GitHub Models, AWS Bedrock, Hugging Face, Moonshot. Auto-detects from API key.

📡

### 18 Channels

CLI, Flutter Web UI, REST API, Telegram, Discord, Slack, WhatsApp, Signal, iMessage, Teams, Matrix, Google Chat, Mattermost, Feishu, IRC, Twitch, Voice (STT/TTS with wake word).

💾

### 6-Tier Cognitive Memory

Core identity, episodic logs, semantic knowledge graph, procedural skills, working memory, tactical memory. 4-channel hybrid search: BM25 + vector + graph + hierarchical document reasoning.

⚙

### PGE Architecture

Planner (LLM) → Gatekeeper (deterministic policy) → Executor (DAG-based parallel sandbox). No hallucinated tool calls — every action is policy-checked before execution.

🔌

### 130+ MCP Tools & A2A

Filesystem, shell, memory, web, browser, media, vault, synthesis, code, skills, social listening, kanban, documents, identity. A2A protocol for agent-to-agent delegation.

🛡

### Security & Audit

Deterministic Gatekeeper (4 risk levels), 4-level sandbox (bubblewrap/Docker/JobObject), SHA-256 audit chain, Fernet AES-256 encryption, API rate limiting, CORS hardening.

🎮

### Flutter Command Center

Sci-Fi UI with glassmorphism, neon glow effects, 5 section colors, morphing sidebar, hacker mode with Matrix rain, Robot Office animation with 8 robots, real-time dashboard.

🔊

### Voice & Chat

Wake word ("Jarvis") with Levenshtein + phonetic matching, Piper TTS (emotional voices), Whisper STT, WebSocket streaming, markdown rendering, file upload.

📚

### Knowledge Vault

Obsidian-compatible Markdown vault with YAML frontmatter, tags, backlinks. Knowledge synthesis with confidence ratings, contradiction detection, gap analysis, and lineage tracking.

🧬

### GEPA Self-Improvement

Guided Evolution through Pattern Analysis. Collects execution traces, performs causal root-cause analysis (10 categories), generates targeted optimizations, auto-applies with rollback safety.

🤖

### Identity & Personality

CognitioEngine with 7 Genesis Anchors, personality vector (6 dimensions), emotion shield, reality check, character crystallization, narrative self, existential layer, dream cycle.

🏪

### Skill Marketplace

Install, search, rate community skills from GitHub registry. Publisher verification with trust levels. agentskills.io SKILL.md format compatibility (Hermes interop).

## GEPA — Self-Improving Agent

Cognithor learns from every interaction. GEPA analyzes failures, finds root causes, and generates targeted improvements — automatically.

📊

#### Collect

Record execution traces

→
🔍

#### Analyze

Causal root-cause analysis

→
💡

#### Propose

Targeted optimizations

→
✅

#### Apply

Test & deploy or rollback

## Architecture

Flutter Command Center (Sci-Fi UI · Chat · Dashboard · Robot Office · Config) REST API + WebSocket (FastAPI, 170+ endpoints, port 8741) Gateway Layer (Sessions · Agent Loop · Personality · Sentiment · Preferences) Context Pipeline (Memory + Vault + Episodes → Enriched Prompt) Planner (LLM) → Gatekeeper (Policy) → Executor (DAG Sandbox) MCP Tools (130+) · A2A Delegation · Browser · Social Listening · Skills 6-Tier Memory · 4-Channel Hybrid Search · GEPA · CAG Layer · Identity Multi-LLM Backend (18 providers · Ollama/LM Studio/vLLM local · Cloud optional)

## Robot Office

Watch 8 animated robots work in real-time. CPU, GPU, RAM, and system load visualized directly in the office scene.

🤖 COGNITHOR HQ
8 robots · desk pathfinding · system monitor · day/night cycle · pets · tap reactions
💻

#### System Monitor

CPU, GPU, RAM, LOAD bars on wall screen

🛤

#### Pathfinding

Robots navigate around desks via corridors

🌅

#### Day/Night Cycle

Sun, moon, stars, ceiling lights adapt

🐾

#### Office Pets

Dog and cat with AI behavior

## Quick Start

From clone to running agent in under 5 minutes.

cognithor — bash

    # Clone & install
    git clone https://github.com/Alex8791-cyber/cognithor.git
    cd cognithor
    pip install -e ".[all,dev]"

    # Pull local models (Ollama)
    ollama pull qwen3:32b       # Planner (20 GB VRAM)
    ollama pull qwen3:8b        # Executor (6 GB VRAM)
    ollama pull qwen3-embedding:0.6b # Embeddings

    # Launch
    cognithor                    # Full mode
    cognithor --lite             # 6 GB VRAM mode

      COGNITHOR · Agent OS v0.90.0
      Backend + UI at http://localhost:8741