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

Stars Python Tests Coverage Lint License Release
★ 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