cognithor

Note: Cognithor is in active development (Beta). While the test suite is extensive (13,000+ tests, 89% coverage), the project has not been battle-tested in production environments. Expect rough edges, breaking changes between versions, and some German-language strings in system prompts and error messages. Contributions, bug reports, and feedback are very welcome. See Status & Maturity for details. For non-technical users, wait until version 1.0.0 for stable long-term support.

Vibe-Engineered, not vibe-coded. Cognithor is not a weekend hack held together by AI-generated spaghetti. Every module follows a deliberate architecture (PGE-Trinity, 6-phase gateway init, 3-layer security), backed by 13,000+ tests, structured plans, spec compliance reviews, and code quality gates. The AI writes the code — but a human engineers the system. There's a difference.

Why Cognithor?

Most AI assistants send your data to the cloud. Cognithor runs entirely on your machine — with Ollama or LM Studio, no API keys required. Cloud providers are optional, not mandatory.

It replaces a patchwork of tools with one integrated system: 18 channels, 130+ MCP tools, 6-tier memory with 4-channel hybrid search, knowledge vault, voice, browser automation, Computer Use, cross-platform social listening, and more — all wired together from day one. 13,000+ tests at 89% coverage keep it honest. See Status & Maturity for what that does and does not guarantee.

In plain terms: Cognithor is an AI assistant that lives entirely on your computer. You talk to it through your terminal, a web UI, Telegram, Discord, or any of 18 supported channels — and it talks back, remembers what you said last week, and acts on your behalf. It can search the web, write and edit files, run shell commands, control your browser, automate your desktop (clicking, typing, reading windows), manage your calendar, and learn new skills over time. Think of it as a local, private, self-improving Jarvis.

Unlike cloud-based assistants, Cognithor keeps all your data on your machine. Your conversations, memories, documents, and credentials never leave your hardware unless you explicitly configure a cloud LLM provider. It works fully offline with Ollama or LM Studio, and it encrypts everything at rest with SQLCipher (AES-256). If privacy matters to you — and it should — this is the architecture you want.

What makes it different from other local AI tools is that Cognithor is not just a chatbot. It is an agent operating system: it plans multi-step tasks, evaluates its own results, learns from mistakes, and improves autonomously. It can control your desktop through Computer Use (screenshots, clicks, keystrokes, window automation), compete in ARC-AGI-3 reasoning benchmarks, and manage a marketplace of community-contributed skills. It is built to grow with you.

Status & Maturity

Cognithor is Beta / Experimental software. It is under rapid, active development.

| Aspect | Status | |--------|--------| | Core agent loop (PGE) | Stable — well-tested and functional | | Memory system | Stable — 6-tier architecture works reliably | | CLI channel | Stable — primary development interface | | Flutter Command Center | Beta — Sci-Fi aesthetic, cross-platform, GEPA pipeline visualization, Robot Office pathfinding, 20+ config pages, chat, voice, learning dashboard | | Messaging channels (Telegram, Discord, etc.) | Beta — basic flows work, edge cases may break | | Voice mode / TTS | Alpha — experimental, hardware-dependent | | Browser automation | Stable — Playwright-based, CAPTCHA solving, stealth mode | | Computer Use | Stable — 6 phases (Vision, Agent Loop, Planner Intelligence, Security, Robustness, UI Automation) | | ARC-AGI-3 Benchmark | Beta — 13/25 games solved (24 levels), 4 solver families incl. SmartExplorer | | Skill Marketplace | Stable — GitHub registry, 5-check validation, publisher verification | | Windows UI Automation | Beta — pywinauto UIA for exact element coordinates | | Deployment (Docker, bare-metal) | Beta — tested on limited configurations | | SSH Remote Execution | Beta — tested against Docker containers, key-based auth | | Evolution Engine | Stable — all 6 phases complete, autonomous deep learning with quality self-examination, GDPR-compliant | | Autonomous Task Framework | Beta — task decomposition, self-evaluation, recurring scheduling | | Background Process Manager | Beta — 6 MCP tools, 5-method ProcessMonitor, SQLite persistence | | Multi-Agent System | Beta — 5 specialized agents with model/temperature/top_p overrides | | Audit & Compliance | Beta — HMAC + Ed25519 signatures, RFC 3161 TSA, GDPR Art. 15/33, WORM-ready | | Enterprise features (GDPR, A2A, Governance) | Stable — GDPR 100% user rights, consent management, SQLCipher encryption, audit trail | | Encryption at Rest | Stable — SQLCipher (AES-256) for all databases, Fernet for files, OS Keyring key management | | Cross-Platform Social Listening | Beta — Reddit + Hacker News + Discord scanning, LLM-scored leads, unified MCP tools | | Hierarchical Document Reasoning | Beta — Tree-based retrieval for PDF/DOCX/HTML/Markdown, LLM-navigated section selection | | CAG Layer (Cache-Augmented Generation) | Beta — Deterministic prefix generation for LLM KV-cache reuse, prefix + native builders | | CLI Config TUI | Stable — Interactive terminal config editor (rich + prompt_toolkit), model discovery | | AST-Based Security | Stable — Python AST + bashlex shell analysis replacing regex-based guards | | OSINT / HIM Module | Beta — person/project/org investigation with trust scoring |

What the test suite covers: Unit tests, integration tests, real-life scenario tests, and live Ollama tests for all modules. The 13,000+ tests verify code correctness in controlled environments.

What the test suite does NOT cover: Real-world deployment scenarios, network edge cases, long-running stability, multi-user load, hardware-specific voice/GPU issues, or actual LLM response quality.

Important notes for users:

• This project is developed by a solo developer with AI assistance. Code is human-reviewed, but the pace is fast.
• Breaking changes may occur between minor versions. Pin your version if stability matters.
• The default language is German, switchable to English via the Flutter Command Center or config.yaml. See Language & Internationalization.
• For production use, thorough testing in your specific environment is strongly recommended.
• Bug reports and contributions are welcome — see Issues.

Cognithor is a fully local, Ollama/LM Studio-powered, autonomous agent operating system that acts as your personal AI assistant. All data stays on your machine — no cloud, no mandatory API keys, full GDPR compliance. It supports tasks ranging from research, project management, and knowledge organization to file management and automated workflows. Optional cloud LLM providers (OpenAI, Anthropic, Gemini, and 11 more) can be enabled with a single API key. Users can add custom skills and rules to tailor the agent to their needs.

Table of Contents

• Why Cognithor?
• Status & Maturity
• Highlights
• Architecture
• LLM Providers
• Channels
• Quick Start (under 5 minutes)
• Configuration
• Security
• MCP Tools
• Tests
• Deployment
• Language & Internationalization
• License
• What's New

Highlights

• 18 LLM Providers — Ollama (local),