Skip to content
View OpenCognit's full-sized avatar
  • Joined Apr 4, 2026

Block or report OpenCognit

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
Opencognit/README.md
OpenCognit

OpenCognit

Build Your Zero Human Company.

The open-source AI agent OS β€” CEO orchestrator, persistent memory, real execution, atomic budgets. Self-hosted. No cloud lock-in. Free forever.

AGPL-3.0 License Node.js 20+ TypeScript GitHub Stars

πŸš€ Quick Start Β· πŸ“– Docs Β· πŸ’¬ Community Β· β˜• Support


If OpenCognit saves you time, a ⭐ star helps others find it.


What is OpenCognit?

OpenCognit is an AI agent orchestration OS β€” not a chatbot, not a single-agent wrapper. It runs a virtual company of autonomous AI agents that work together without you watching.

You set a goal. The CEO agent breaks it down, assigns tasks to specialists, reviews their work with a built-in Critic loop, and escalates blockers β€” while you sleep.

You β†’ Goal β†’ CEO Agent β†’ Dev Agent β†’ Writer Agent β†’ Researcher Agent
                 ↑               ↓              ↓
          Persistent Memory ←── Critic ←── Results β†β”€β”€β”€β”€β”˜

Why OpenCognit?

Problem OpenCognit
Agents lose context on restart Persistent Memory memory per agent
No quality control β€” agents ship anything Critic/Evaluator Loop: every output is reviewed before marking done
API costs run away overnight Atomic Budgets: agents pause at your limit
Task context lost between agents Task-Output-as-Input: blocker results flow downstream automatically
Sequential agent wakeups (slow) Parallel wakeups via Promise.all
Manual task orchestration CEO Extended Thinking: Sonnet reasons before acting
No memory across sessions SOUL documents + Memory per agent
Scattered configs Full UI: Org Chart, Goals, Kanban, War Room

Core Features

🧠 CEO Orchestrator with Extended Thinking

The CEO agent uses claude-sonnet-4-6 with Anthropic's Extended Thinking β€” it reasons step-by-step before making decisions. It delegates tasks via native tool calls (not JSON parsing), calls team meetings, and requests board approval for hiring.

πŸ’Ύ Persistent Memory System

Each agent has its own memory with Rooms (key-value), Diary (structured entries), and a Knowledge Graph (subject-predicate-object triplets). Agents tag important outputs with [REMEMBER:room] β€” parsed and saved automatically. Old memories consolidate into LLM-compressed summaries.

πŸ” Planner β†’ Executor β†’ Critic Loop

Every task result goes through a lightweight evaluator (Haiku) before being marked done. If insufficient, the agent retries β€” up to 2 times β€” before escalating to the board. No silent failures.

πŸ”— Task Chaining

Define blocking relationships between tasks. When Task A completes, dependent tasks are automatically unlocked and their assigned agents are woken β€” no manual intervention.

πŸͺͺ SOUL Documents

Each agent gets a structured identity document β€” IDENTITY, DECISION PRINCIPLES, CYCLE CHECKLIST, PERSONALITY β€” generated by LLM or hand-crafted. Solves the "Memento Problem" where agents forget who they are across sessions.

⏱️ Configurable Heartbeat

Each agent wakes on its own schedule (5m, 15m, 1h, 24h, or custom). The heartbeat is the core of autonomy β€” it processes inbox tasks, runs adapters, tracks costs, and feeds results back to the team.

🏒 Full Control Plane

  • Dashboard β€” live agent grid, system pulse, company health score
  • War Room β€” full-screen mission control with animated counters
  • Meetings β€” agents can call peer meetings, synthesize results
  • Goals (OKR) β€” 4-level hierarchy, progress tracking
  • Kanban β€” tasks with Critic-reviewed outputs
  • Activity β€” 28-day heatmap, filtered feed
  • Routines β€” cron-based automations
  • Memory β€” browsable agent memory with Knowledge Graph viz
  • Telegram β€” mobile interface with /status, /tasks, free-form chat

Quick Start

Option A β€” One-line installer (recommended)

bash <(curl -fsSL https://raw.githubusercontent.com/OpenCognit/opencognit/main/install.sh)

Interactive wizard: asks for project name + optional API key, clones the repo, installs deps, generates secrets, migrates DB, builds frontend. Done in under 2 minutes.

opencognit
# β†’ http://localhost:3201

Option B β€” Docker

git clone https://github.com/OpenCognit/opencognit.git
cd opencognit
docker compose up
# β†’ http://localhost:3201

Data is persisted in ./data/ β€” safe across restarts.


Option C β€” Manual Setup

Requirements: Node.js β‰₯ 20

git clone https://github.com/OpenCognit/opencognit.git
cd opencognit
bash setup.sh   # installs deps, generates keys, migrates DB, builds frontend
npm start
# β†’ http://localhost:3201

First Steps After Setup

  1. Create your company β€” name it, describe its goal
  2. Configure API keys β€” Settings β†’ add Anthropic or OpenRouter key
  3. Set default model β€” Settings β†’ Standard-Modell (all agents use this unless overridden)
  4. Add a CEO agent β€” set connection type to ceo, enable Orchestrator flag
  5. Add worker agents β€” give them roles, skills, heartbeat intervals
  6. Create your first goal β€” CEO will start breaking it down autonomously

Supported AI Providers

Provider Use Case
Anthropic (Claude) CEO Extended Thinking, Critic Loop, SOUL generation
OpenRouter Worker agents (100+ models, unified API)
OpenAI GPT-4o, GPT-4o-mini
Ollama Local models (Llama 3, Mistral, etc.)
Claude Code CLI Code execution with session persistence
Gemini CLI Google models
Bash Shell commands
HTTP External APIs

Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                    React 19 Frontend                      β”‚
β”‚  Dashboard Β· Agents Β· Tasks Β· Meetings Β· Intelligence   β”‚
β”‚  Goals Β· War Room Β· Memory Β· Costs Β· SOUL Editor     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                         β”‚ REST + WebSocket + SSE
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                   Express 5 API Server                    β”‚
β”‚                                                          β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”‚
β”‚  β”‚  Heartbeat   β”‚  β”‚  Cron Sched  β”‚  β”‚  CEO Adapter  β”‚  β”‚
β”‚  β”‚  Runner      β”‚  β”‚  (30s tick)  β”‚  β”‚  + Thinking   β”‚  β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜  β”‚
β”‚         β”‚                                                 β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚
β”‚  β”‚           Adapter Registry                           β”‚ β”‚
β”‚  β”‚  Bash Β· HTTP Β· Claude Code Β· OpenRouter Β· Ollama    β”‚ β”‚
β”‚  β”‚  Critic Loop Β· Task Chaining Β· Token Budget Guard   β”‚ β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚
β”‚         β”‚                                                 β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”‚
β”‚  β”‚                  Memory                        β”‚    β”‚
β”‚  β”‚  Wing Β· Rooms Β· Diary Β· KG Β· Consolidation        β”‚    β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β”‚
└─────────────────────────────────────────────────────────-β”˜
                         β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚              SQLite (self-hosted, no cloud dependency)    β”‚
β”‚  Agents Β· Tasks Β· Goals Β· Memory Β· Meetings Β· Costs     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Tech Stack

Layer Technology
Frontend React 19 + Vite 6
UI Glassmorphism design system, Lucide icons
Routing React Router v7
Backend Express 5 (Node.js)
Database SQLite via better-sqlite3 + Drizzle ORM
Auth JWT + bcrypt
Real-time WebSocket + SSE
Language TypeScript (strict, full-stack)
Runtimes Claude Code CLI, Anthropic, OpenRouter, Ollama, OpenAI

Project Structure

opencognit/
β”œβ”€β”€ server/
β”‚   β”œβ”€β”€ index.ts              # Express + all API endpoints
β”‚   β”œβ”€β”€ db/schema.ts          # Drizzle schema (SQLite)
β”‚   β”œβ”€β”€ services/
β”‚   β”‚   β”œβ”€β”€ heartbeat.ts      # Agent cycle runner + Critic Loop
β”‚   β”‚   β”œβ”€β”€ cron.ts           # Cron scheduler
β”‚   β”‚   β”œβ”€β”€ wakeup.ts         # Wakeup coalescing
β”‚   β”‚   β”œβ”€β”€ memory-auto.ts # Auto-save + REMEMBER protocol
β”‚   β”‚   └── messaging.ts      # Telegram + channels
β”‚   └── adapters/
β”‚       β”œβ”€β”€ ceo.ts            # CEO Orchestrator + Extended Thinking
β”‚       β”œβ”€β”€ claude-code.ts    # Claude Code CLI adapter
β”‚       └── registry.ts       # Adapter auto-selection
└── src/
    β”œβ”€β”€ pages/                # All UI pages
    β”œβ”€β”€ components/           # Shared components
    └── i18n/                 # DE + EN translations

Self-Hosting

OpenCognit is 100% self-hosted. Your data never leaves your machine:

  • Database: SQLite file in ./data/
  • API keys: encrypted at rest
  • No telemetry, no analytics, no external dependencies

The only outbound connections are the LLM API calls you configure.


Roadmap

  • Electron desktop app (one-click, no terminal)
  • Agent marketplace (community plugins)
  • Multi-tenant cloud deployment option
  • Web-based IDE integration (Cursor / Windsurf)
  • Mobile dashboard
  • Agent OAuth delegation

OpenCognit vs. Other AI Agent Frameworks

OpenCognit AutoGPT CrewAI LangChain Agents n8n AI
Multi-agent org chart βœ… ❌ βœ… ❌ ❌
CEO orchestrator βœ… ❌ ❌ ❌ ❌
Persistent per-agent memory βœ… ⚠️ ❌ ❌ ❌
Built-in Critic/QA loop βœ… ❌ ❌ ❌ ❌
Atomic budget per agent βœ… ❌ ❌ ❌ ❌
Full UI (no code) βœ… ⚠️ ❌ ❌ βœ…
Self-hosted, no cloud βœ… βœ… βœ… βœ… βœ…
Local models (Ollama) βœ… ⚠️ βœ… βœ… βœ…
Claude Code CLI integration βœ… ❌ ❌ ❌ ❌
Free forever βœ… βœ… βœ… βœ… ⚠️

Looking for an AutoGPT alternative, CrewAI alternative, or open-source multi-agent system? OpenCognit adds a full org chart, persistent memory, and a built-in quality loop on top.


Contributing

Pull requests welcome. See CONTRIBUTING.md for guidelines.


Support

OpenCognit is free and open-source. If it saves you time or helps your business, consider supporting development:

β˜• Ko-fi
πŸ’– GitHub Sponsors

Every contribution helps keep this project alive and actively maintained.


License

AGPL-3.0 β€” see LICENSE

Commercial licensing (SaaS / enterprise closed-source) available on request via GitHub Issues.


Built with TypeScript, React 19, Express 5 β€” and a lot of autonomous agents eating their own dogfood.

Popular repositories Loading

  1. Opencognit Opencognit Public

    The open-source AI agent OS. CEO orchestrator, persistent memory, real execution, atomic budgets. Self-hosted. No cloud lock-in.

    TypeScript 6