A persistent, self-learning AI agent system modelled on the human brain. 12 independent OOP agents communicate via async event bus. The brain can search the web, learn new topics, and create its own tools and MCP servers at runtime.
You -> Atlas: /forge a tool that fetches weather from wttr.in for any city
Atlas: Forging tool: a tool that fetches weather from wttr.in for any city
Atlas: Created tool: weather_fetch
You -> Atlas: /forge mcp a server that manages TODO lists in JSON files
Atlas: Created MCP server: mcp_todo_manager (tools: add_todo, list_todos, complete_todo)
You -> Atlas: /learn how to use the Stripe API in Python
Atlas: Learned about 'Stripe API': Stripe provides a Python SDK for...
Key facts: pip install stripe; Use stripe.api_key; Create PaymentIntent...
Tool suggestion: A tool that creates Stripe payment intents
You -> Atlas: /parallel What is Python? | What is Rust? | What is Go?
PARALLEL RESULTS (3 tasks):
[✓] p_0 (1.2s): Python is a high-level...
[✓] p_1 (1.1s): Rust is a systems programming...
[✓] p_2 (0.9s): Go is a statically typed...
| Brain Region | Agent Role | Key Responsibility |
|---|---|---|
| Prefrontal Cortex | Orchestrator | Plans tasks, coordinates all regions |
| Hippocampus | Memory | Vector + SQLite + keyword search, memory graph |
| Amygdala | Safety Filter | Risk evaluation, pattern blocking |
| Cerebellum | Quality + Self-Improve | Reviews, quality trends, recurring issue detection |
| Wernicke's Area | Input Parser | Intent detection, entity extraction |
| Broca's Area | Output Renderer | Terminal formatting, API responses |
| Thalamus | Router + Handoff | Routes messages, agent-to-agent handoff chains |
| Reticular Formation | Scheduler | Priority queue, background task loop |
| Basal Ganglia | Automation | 21 slash commands, skills, macros |
| Anterior Cingulate | Conflict Detector | Detects ambiguity and contradictions |
| Sensory Cortex | Input Processor | Normalizes text, files, URLs |
| Motor Cortex | Tool Executor | Runs all approved tool/plugin calls |
# Docker
docker pull ghcr.io/masterdeepak15/agents:latest
docker run -it -e ANTHROPIC_API_KEY=your_key ghcr.io/masterdeepak15/agents
# Local Python
git clone https://github.com/masterdeepak15/Agents.git
cd Agents
pip install -r requirements.txt
python main.py --provider anthropic| Command | What it does |
|---|---|
/status |
Brain health, all region stats, scheduler, audit, forge |
/plan <goal> |
Create a multi-step execution plan |
/memory |
View memories (vector + SQLite + in-memory) |
/search <query> |
Semantic memory search |
/tools |
List all loaded tools (built-in + plugins + MCP + forged) |
/learn <topic> |
Self-learn from the web |
/learn deep <topic> |
Deep learning with more detail |
/forge <desc> |
Create a new tool at runtime |
/forge mcp <desc> |
Create a new MCP server at runtime |
/parallel t1 | t2 |
Run multiple tasks concurrently |
/reflect |
Brain self-reflection |
/remember <text> |
Store a memory permanently |
/webhook |
View webhook channels |
/schedule |
View scheduled tasks & file watches |
/audit |
View recent audit log |
/quality |
View quality trend + recurring issues |
/export |
Export memories to JSON |
/skills |
List skill library |
/save |
Save memory to disk |
/clear |
Clear working memory |
/quit |
Graceful shutdown |
AgentTerminal/
├── brain.py ← assembles all 12 agents (v2.2)
├── main.py ← CLI entry point
├── config/brain_config.yaml ← all configuration
├── core/
│ ├── base_agent.py ← OOP base all agents extend
│ ├── context_manager.py ← token budget management
│ ├── event_bus.py ← async pub/sub bus
│ ├── providers.py ← 7 LLM backends
│ ├── mcp_client.py ← MCP server connector
│ ├── vector_store.py ← ChromaDB vector search (v2.1)
│ ├── sqlite_store.py ← SQLite FTS5 backend (v2.1)
│ ├── streaming.py ← Token streaming (v2.1)
│ ├── scheduler.py ← Cron/file watch/tasks (v2.1)
│ ├── audit.py ← Security audit log (v2.1)
│ ├── tool_forge.py ← Self-create tools & MCP servers (v2.2)
│ ├── self_learn.py ← Web search, learn, adapt (v2.2)
│ ├── parallel.py ← Parallel task pool (v2.2)
│ └── webhook.py ← HTTP webhook triggers (v2.2)
├── agents/ ← 12 brain region agents
├── tools/
│ ├── plugin_base.py ← BrainPlugin base class
│ ├── builtin/skills.py ← 10 built-in tools
│ ├── plugins/ ← auto-discovered plugins
│ │ ├── browser_tool.py ← Playwright browser
│ │ ├── database_tool.py ← SQL queries
│ │ ├── pdf_tool.py ← PDF reader
│ │ ├── email_tool.py ← SMTP/IMAP
│ │ ├── calendar_tool.py ← Calendar events
│ │ └── image_gen_tool.py ← DALL-E image gen
│ └── mcp_servers/ ← Runtime-generated MCP servers (v2.2)
├── api/
│ ├── api_server.py ← FastAPI REST (40+ endpoints)
│ └── dashboard.py ← Web dashboard + WebSocket
├── docs/ ← documentation
└── tests/ ← unit tests
POST /chat · POST /chat/stream · POST /plan · GET /status · POST /reflect
GET /memory · GET /memory/search · GET /memory/graph/{id} · GET /memory/export · POST /memory/import · POST /memory/decay · POST /remember
GET /tools · POST /tool/{name} · GET /skills · POST /skill
POST /forge/tool · POST /forge/mcp · GET /forge/status
POST /learn · POST /learn/url · POST /learn/create · GET /learn/status
POST /webhook/{channel} · POST /webhook · GET /webhooks
POST /parallel
GET /scheduler · GET /scheduler/tasks · POST /scheduler/add · POST /scheduler/watch
GET /audit · GET /audit/stats · POST /auth/token · GET /auth/tokens
GET /dashboard · WS /ws · GET /events
MIT — see LICENSE