[ INSTALL FLOW · v0.82 ]

CLONE · INSTALL · RUN

Cognithor is free, open source, and runs entirely on your machine. No API keys. No subscription. No telemetry. Just clone the repo and go.

★ View on GitHub▼ Latest Release☆ Report an Issue
INSTALL · 5 COMMANDS
01$git clone https://github.com/Alex8791-cyber/cognithor.git
# clone the repo
02$cd cognithor
03$python -m venv venv && venv\Scripts\activate
# Windows (PowerShell: venv\Scripts\Activate.ps1)
04$pip install -r requirements.txt
# install Python deps
05$python -m cognithor
# boot the agent OS (or: cognithor)
First boot downloads the default model pack · takes 5-15 min depending on your bandwidth · stays local forever after that
SYSTEM REQUIREMENTS
Python
3.11 or newer
Ollama
for local LLM inference
RAM
16 GB minimum, 32 GB recommended
GPU
optional — CUDA or Apple Metal for speed
Disk
30 GB (models + vault + episodic memory)
OS
Windows 10/11 · macOS 12+ · Linux (x64)
WHAT YOU GET
  • ■19 pre-wired LLMs via Ollama (qwen3:27b, llama, phi, …)
  • ■18 chat channel adapters (Telegram, Slack, Discord, iMessage, Matrix, …)
  • ■145 MCP tools across 12 modules — filesystem, shell, web, vault, vision, code…
  • ■6-layer memory stack (Identity · Core · Knowledge · Episodic · Entities · Tactical)
  • ■PGE Trinity gateway — Planner · Gatekeeper · Executor with HITL & escalation
  • ■Evolution RAG + meta-learner for idle-time self-improvement
  • ■Zero telemetry, zero cloud, zero vendor lock-in
LICENSE · APACHE 2.0

Cognithor is licensed under Apache License 2.0. Free for personal, commercial, and derivative use. Contribute back, fork freely, ship your own agent OS — just keep the notice.

© 2026 Alexander Söllner · built in Germany · contributors

$ git clone ▸