Cognithor: A Local-First Autonomous Agent OS for AI Automation

Introduction

Cognithor is an advanced, local-first autonomous agent operating system designed for AI experimentation and personal automation. Built with Python 3.12+ and licensed under Apache 2.0, Cognithor distinguishes itself by keeping all your data on your machine, offering unparalleled privacy and GDPR compliance. It integrates a wide array of functionalities, supporting 19 LLM providers, 17 communication channels, and featuring a sophisticated 6-tier cognitive memory system. This platform aims to replace a patchwork of individual AI tools with one cohesive, self-improving system.

Installation

Getting started with Cognithor is straightforward, with several installation options available:

Windows Installer (Recommended for Windows)

Download CognithorSetup-{version}.exe from the latest release.
Run the installer to bundle Python, Ollama, Flutter UI, and all dependencies.
Launch via Desktop shortcut or Start Menu.
The browser will open at http://localhost:8741.

Linux / macOS / Source Install

# Clone the repository
git clone https://github.com/Alex8791-cyber/cognithor.git
cd cognithor

# Linux/macOS: Interactive installer (venv, Ollama, models, systemd)
chmod +x install.sh && ./install.sh

# Or manual pip install
pip install -e ".[all,dev]"

PyPI (Any Platform)

pip install cognithor[all] # Installs core + all optional features
ollama pull qwen3:8b       # Pull a local LLM model
cognithor                  # Start the agent

After installation, ensure you pull a local LLM model like ollama pull qwen3:32b for the Planner and ollama pull qwen3:8b for the Executor, or configure a cloud LLM API key.

Examples

Cognithor empowers users with a broad range of autonomous capabilities:

Multi-step Task Automation: The agent can plan and execute complex, multi-step tasks, learning from its mistakes and improving over time.
Desktop Automation (Computer Use): Control your desktop by taking screenshots, analyzing them with a vision model, clicking at pixel coordinates, typing text, and automating window interactions.
Knowledge Management: Utilize an Obsidian-compatible Knowledge Vault for persistent notes, enhanced by a 6-tier cognitive memory system and 4-channel hybrid search for efficient information retrieval.
Communication Hub: Interact with Cognithor through various channels, including CLI, Web UI, Telegram, Discord, and more, enabling seamless integration into your daily workflow.
Skill Marketplace: Expand Cognithor's capabilities by installing Agent Packs from a community-contributed marketplace, offering new tools and workflows.
Multi-Agent Systems: Leverage the Crew-Layer API to orchestrate teams of specialized agents for complex projects, with features like parallel execution and guardrails.

Why Use Cognithor?

Cognithor stands out as a powerful solution for several compelling reasons:

Unmatched Privacy: It is fundamentally local-first, meaning all your data, conversations, and memories remain on your machine. With zero telemetry and SQLCipher encryption at rest, your privacy is prioritized. It works fully offline with local LLMs like Ollama or LM Studio.
Integrated Autonomy: Unlike simple chatbots, Cognithor is an agent operating system. It plans, evaluates, learns, and improves autonomously, capable of controlling your desktop and managing complex workflows.
Extensive LLM Support: With support for 19 LLM providers, including local options and major cloud services, you have the flexibility to choose the best model for your needs, with optional cloud integration.
Comprehensive Toolset: It offers 141 MCP tools across 30 modules, covering everything from filesystem operations and web browsing to media analysis and document reasoning, all wired together from day one.
GDPR Compliance: Designed with privacy by design, Cognithor offers 100% GDPR user rights coverage, including consent management, right to erasure, and a tamper-evident audit trail.

Cognithor: A Local-First Autonomous Agent OS for AI Automation

Summary

Repository Information

Topics

Use at your own risk