v1.5.20 β€” The Portable Agent Operating System
🧠 AIBrain

The Persistent Memory Layer
for AI Agents

AIBrain is the AI agent memory layer that compounds across every session. It gives any agent a persistent memory layer β€” plus Agent/Task/Team composition, a Flow engine, document ingestion, universal MCP memory server connectivity, 71 self-learning workflows, mesh networking, and a 60-page native dashboard. Install a brain pack and your agent has years of expertise in minutes.

We’ll only email you about AIBrain updates. Unsubscribe any time.
Install from PyPI Β· click to copy
pip install aibrain
Then run: aibrain setup
Free. Python 3.10+ Β· Windows, macOS, Linux.
Native desktop app returning in v3 β€” the CLI and API are the stable shipping path today.

# Brain API
from aibrain import Brain
brain = Brain()
brain.add("I love tennis", user_id="alice")
brain.search("hobbies", user_id="alice")
Click to copy.
9
MCP Servers
15
Built-in Tools
71
Workflows
60+
Dashboard Pages
2,373
Tests Passing
100%
Local / Private

Brain Packs

Pick what fits your life. Each pack is a complete brain transplant β€” workflows, skills, knowledge, and personality.

Productivity Free
Stay organised, never miss a task
10 workflows + email triage + daily planning skills
Developer Pro
Ship faster, catch issues earlier
10 workflows + code review + security skills
Content Creator Pro
Create more, schedule smarter
11 workflows + 8 platforms + scheduling skills
Security Pro Pro
Find vulnerabilities, track threats
6 workflows + OWASP + threat modelling skills
Business Pro
Track competitors, monitor revenue
8 workflows + market intel + outreach skills
Research Pro
Stay current, connect the dots
6 workflows + paper synthesis + citation tracking
Multi-Agent Ops Pro
Coordinate AI agents as a team
6 workflows + memory sync + handover generation
Job Hunter Pro
Find, apply, track automatically
5 workflows + application tracking + interview prep

Free

Everything you need to start

$0

Single instance • 71 workflows • 9 MCP servers • 60-page dashboard • Local SQLite • No credit card

Install Free

Team

Multi-machine, multi-agent

$29.95/mo

Up to 10 workers • Cross-machine via Tailscale • Team brain sharing • Priority support

Get Team

Not another memory tool

Other tools give you an empty notebook. AIBrain is a complete AI agent memory operating system β€” a local MCP memory server, 9 built-in MCP servers, workflows, mesh networking, and a dashboard. Whether you need LangChain persistent memory, an agent memory layer for CrewAI, or a universal brain for any MCP client β€” it ships out of the box.

🧠

Self-Learning Memory

Brain API β€” add memories in 3 lines of code. Automatic fact extraction from conversations, memory deduplication (no duplicates ever), per-user memory scoping, and full change history tracking. Powered by SelRoute, the research-backed retrieval engine validated on 62,000+ instances.

👥

Companies & Teams

Agent Teams with task routing, org charts, company structure, and goal tracking built in.

🔀

Flow Engine

Decorator-driven state machines. @start, @listen, @router decorators build execution graphs with conditional routing. Typed state, persistence for long-running flows, human-in-the-loop pause/resume, @retry, @timeout, and visualization.

📄

Document Ingestion

brain.ingest("file.pdf") β€” feed documents directly into memory. 7 source types: PDF, CSV, Excel, JSON, JSONL, Text, Markdown, and directories. Sentence-aware chunking. Incremental β€” re-running skips already-processed files.

🔌

Universal MCP Client

Connect to any MCP server from Python. Three transports: stdio, HTTP, SSE. Tool bridging turns remote MCP tools into local callable functions. Registry manages multiple servers from code or the dashboard.

🌐

Web Search

Built-in web search β€” no API keys needed. Your agent can search the web, fetch pages, and summarise results. Zero config, works immediately.

📦

Brain Packs

Install a pack and your agent has years of expertise in minutes. Workflows, skills, knowledge, and personality β€” 8 domains pre-configured.

🛠

IT Support

Built-in system diagnostics, service monitoring, and automated remediation. 9 tools + 8 workflows + ticketing system. Your agent is also your IT department.

🔗

Tailscale Mesh Networking

Encrypted agent-to-agent communication over Tailscale. Send files, sync brains, share skills between devices β€” no port forwarding, works across NAT.

📱

Mobile (PWA)

Install AIBrain on your phone as a Progressive Web App. Full dashboard, push notifications for approvals, offline access. No app store needed.

💻

Buildit AI Code Editor

Built-in AI code editor with live preview. Write, debug, and deploy code with your agent's help.

📅

Calendar & Files

Manage calendars (CalDAV + local), search and organize files, find duplicates, auto-classify documents. Your agent handles the busywork.

🎨

Design

Generate social media images, banners, and thumbnails programmatically. Built-in templates for LinkedIn, X, YouTube. Your agent creates your content visuals.

💰

Cost Analytics

Real-time LLM cost tracking by model and task. Know exactly what each workflow costs.

🔄

Brain Evolution

Your agent scores every run, extracts learnings, and improves automatically. Compounds across sessions.

🧪

Auto-Experiment

Automated optimization loops β€” hypothesise, modify, evaluate, keep or revert. Your agent improves its own performance using the scientific method.

🔒

100% Local & Private

Everything runs on your machine. SQLite database, no cloud dependency. Works with any LLM β€” Claude, GPT, Gemini, Llama, Ollama. No vendor lock-in.

Running in 3 minutes

From zero to a trained brain in three steps.

1

Install

One command. The setup wizard handles Python, dependencies, database, config, and MCP registration automatically.

2

Pick a Pack

Choose your domain. Workflows, skills, knowledge, and agent personality all pre-loaded and ready to run.

3

Start

aibrain start β€” stack restores, services launch, dashboard opens. Your agent is ready.

What's Inside

Everything your agent needs to be genuinely useful. No assembly required.

🧠 Self-Learning Memory

The core agent memory layer β€” add, search, and manage memories in 3 lines of code. SQLite + FTS5 full-text search with optional vector embeddings. Works as a drop-in LangChain persistent memory backend or standalone Brain API. Powered by SelRoute, a research-backed hybrid retrieval engine published on arXiv.

  • Full Brain API: Brain().add(), .search(), .get_all(), .delete()
  • Automatic fact extraction from conversations
  • Memory deduplication β€” no duplicates ever stored
  • Per-user memory scoping with user_id parameter
  • Full change history tracking for every memory
  • Semantic search with MiniLM or bge-base embeddings
  • 6 memory types: user, feedback, project, reference, pattern, decision
  • Hyperedge relationships and entity extraction
  • Evolution cycles that compress, merge, and strengthen memories
  • Export/import your entire brain as JSON

👥 Agent/Task/Team System

Typed multi-agent composition β€” define agents, create tasks, run teams. Sequential or hierarchical processes with delegation and guardrails.

  • from aibrain import Agent, Task, Team β€” three imports, you're building
  • Agents with role, goal, and backstory
  • Tasks with expected output, tools, and validation guardrails
  • Sequential process: tasks run in order, outputs chain
  • Hierarchical process: manager delegates to workers
  • Delegation between agents within a team
  • Automatic retry with configurable limits on guardrail failure
  • Structured output: TeamOutput and TaskOutput objects

🔀 Flow Engine

Decorator-driven state machines for complex, multi-step workflows. Build execution graphs with conditional routing, persistence, and human-in-the-loop support.

  • @start, @listen, @router decorators define the execution graph
  • Typed state objects via Pydantic β€” validated and serializable
  • Conditional routing: @router returns a string to select the next branch
  • Persistence for long-running flows β€” save and resume later
  • Human-in-the-loop: pause for approval, resume programmatically
  • @retry and @timeout decorators for resilience
  • Flow visualization β€” generate diagrams of execution paths

📄 Document Ingestion

Feed documents directly into brain memory. brain.ingest() handles 7 source types with intelligent chunking and incremental processing.

  • brain.ingest("file.pdf") β€” one line to ingest any document
  • PDF, CSV, Excel, JSON, JSONL, Text, Markdown support
  • Directory ingestion β€” point at a folder, ingest everything
  • Sentence-aware chunking with configurable overlap
  • Incremental: re-running skips already-processed files
  • Named collections for organizing ingested content
  • Search across all ingested documents with brain.search()

🔗 Universal MCP Client

Connect to any MCP server from Python. Three transports, tool bridging, and a registry for managing multiple servers.

  • MCPServerStdio: launch subprocess-based servers (npx, python)
  • MCPServerHTTP: connect to remote HTTP MCP endpoints
  • MCPServerSSE: Server-Sent Events streaming transport
  • Tool bridging: remote MCP tools become local Python functions
  • Registry manages multiple servers with named entries
  • Dashboard /mcp page for visual management
  • Works alongside AIBrain's 9 built-in MCP servers

🔄 71 self-learning workflows

Pre-built automations across six registries. Enable any workflow with a single toggle. All schedules are configurable via cron expressions.

  • Email triage, ArXiv tracker, autonomous researcher
  • Code analysis, security scanning, CI/CD monitoring
  • Content scheduling across 7 platforms
  • Self-improvement: burnout detector, brain sync checker
  • Natural language workflow creation β€” describe it, AIBrain builds it

🔌 9 MCP Servers (15 Built-in Tools)

Full MCP server suite that any compatible agent can connect to. Each server is a focused capability module.

  • Memory: store, search, recall, evolve, graph
  • Peer Discovery: find and connect to other AIBrain agents
  • Web Search: search and fetch with no API keys
  • IT Support: diagnostics, monitoring, remediation
  • Calendar, Design, Desktop, Files: full system integration

🌐 Tailscale Mesh Networking

Encrypted peer-to-peer communication between AIBrain agents on any device, anywhere. No port forwarding. Works across NAT.

  • Agent-to-agent messaging over encrypted Tailscale tunnels
  • File transfer with SHA256 verification
  • Brain sync β€” merge knowledge between agents
  • Consensus-weighted merge for multi-agent teams
  • Peer registry with automatic discovery

📬 Telegram + Email Integration

Your agent stays connected. Telegram bot notifications for approvals and alerts. IMAP/SMTP email monitoring with auto-reply capability.

  • Telegram bot with push notifications
  • Email inbox monitoring with triage workflows
  • Auto-reply mode with sender whitelisting
  • Content pipeline: schedule posts across 7 platforms
  • Webhook triggers for GitHub, payments, CI results

📊 45-Page Dashboard

Full browser UI for everything your agent does. Not a toy dashboard β€” 45+ pages with teams, flows, ingestion, MCP management, and real-time WebSocket updates.

  • Visual workflow builder with drag-and-drop node editor
  • Interactive knowledge graph with entity extraction
  • Cost tracking with daily/monthly budgets
  • Command palette (Ctrl+K), keyboard shortcuts
  • Mobile PWA with QR pairing and push notifications

🧬 Evolution Engine

Your agent improves itself. Outcomes feed patterns, patterns generate hypotheses, hypotheses run experiments, experiments get measured and kept or reverted.

  • Pattern detection across all workflow domains
  • Hypothesis testing with automated evaluation
  • Self-criticism and loop detection
  • Skill version tracking with health monitoring
  • Positive pattern reinforcement β€” good habits compound

Setup Wizard

One command gets you from zero to running. The wizard detects your environment and configures everything automatically.

  • Auto-detects existing databases and migrates them
  • Configures MCP servers for your agent (Claude, Cursor, etc.)
  • Cross-platform: Linux, macOS, Windows
  • Interactive or fully automatic (--auto flag)
  • Stack snapshots for crash recovery and state restore

AI Companies

Build a team of AI agents that work together, learn together, and get better every day.

Your own AI company β€” CEO, managers, workers, all powered by one brain

👑 Company Hierarchy

CEO delegates to managers, managers assign to workers. Real org chart with reporting chains, roles, and responsibilities β€” just like a human company.

📋 Task Management

Create tasks, assign to agents, track progress. Agents claim work, execute via LLM, submit for QA review. Quality gating ensures nothing ships without meeting standards.

📈 Goal Tracking

Set company goals with milestones and deadlines. Track progress across the whole team. Sub-goals break big objectives into agent-sized work.

💡 Heartbeat System

Agents wake on schedule, check for work, execute tasks, and learn from the results. CEO agents can delegate and create new tasks for idle workers.

🔒 Secrets Vault

Store API keys and credentials securely. Encrypted at rest, scoped per agent or company-wide. Agents access only what they need.

🧠 Shared Brain

Every agent feeds the same brain. Knowledge from every task compounds. The whole company gets smarter with every heartbeat.

🏢

8 LLM Adapters

Claude, GPT, Gemini, Ollama, Groq, Together, DeepSeek, or your own local server. Each agent can use a different provider.

Model Routing

Simple tasks use cheap models ($0 with Ollama). Complex tasks use Opus. Automatic routing minimizes cost.

🛡

Approval Gates

Quality reviews, hire approvals, escalations. Nothing happens without the right authority level.

📊

Full Dashboard

60-page dashboard with teams, flows, ingestion, org charts, agent detail, task tracking, cost analytics, and evolution monitoring.

🔄

Self-Improvement

Evolution engine analyses outcomes, proposes experiments, and applies what works. Your company gets better autonomously.

🔐

Role-Based Access

Owner, admin, member, viewer. Invite team members with the right permissions. API key auth for external access.

Free

1 company, 2 agents, full dashboard
$0

Pioneer Pro

Unlimited companies, 10 agents, 8 adapters, model routing
$9.95/mo

Team

50 agents, cross-machine, team brain sharing, RBAC
$29.95/mo

Architecture

AIBrain sits between your agent and everything it needs. One brain layer, any agent.

Your Agent
Claude Code
Cursor
Copilot
Ollama
Any MCP Client
Brain Layer
AIBrain
Capabilities
Memory DB
Agent Teams
Flow Engine
9 MCP Servers
Doc Ingestion
MCP Client
71 Workflows
Mesh Network
Dashboard
Evolution
Scheduler
Approvals

Works With Your Agent

AIBrain is agent-agnostic. It works as an MCP memory server for any MCP-compatible client, and as a native persistent memory layer for LangChain, LangGraph, LlamaIndex, OpenAI Agents SDK, and CrewAI.

💻
Claude Code
MCP Client
📝
Cursor
MCP Client
GitHub Copilot
MCP Client
🦙
Ollama
Local LLM
🤖
Any MCP Client
MCP Protocol

Built for privacy

Your data never leaves your machine. Not even a little bit.

💾

100% Local Storage

SQLite database on your filesystem. No cloud. No syncing to someone else's server.

🚫

No Telemetry

Zero analytics, zero tracking, zero phone-home. We don't know you installed it.

🔐

Your Keys, Your LLM

Bring your own API keys or use Ollama for fully offline operation. No vendor lock-in.

📦

Portable Brain

Copy one file to move your entire brain. Export as JSON, import anywhere. You own it.

Documentation

Everything you need to get started, build workflows, and extend AIBrain.

Getting Started

Install AIBrain, run the setup wizard, and launch your first brain pack in under 5 minutes.

User Guide

Complete guidebook covering memory, workflows, brain packs, dashboard, mesh networking, and more.

Workflow Reference

All 71 workflows documented. Triggers, schedules, configuration options, and customization.

API Documentation

165+ REST endpoints. Memory, workflows, approvals, chat, agents, health checks, and more.

Simple pricing

Free tier is genuinely useful. Pro unlocks the full brain. Team scales it.

Free

$0
Forever
  • + Persistent memory (7 MCP tools)
  • + Web search (5 tools, no API key needed)
  • + 22 self-learning workflows
  • + Basic file management
  • + Local calendar (.ics)
  • + Dashboard UI + PWA mobile
  • + Stack snapshots + crash recovery
  • + Productivity brain pack
  • + Full API + approval queue
pip install aibrain

Team

$29.95/mo
Per team β€” up to 50 agents
  • + Everything in Pro
  • + AI Companies with org charts
  • + Teams in Companies β€” run agent teams from the dashboard
  • + Goal tracking with milestones
  • + Role-based access control (RBAC)
  • + Encrypted secrets vault
  • + Up to 50 agents
  • + Cross-machine sync via Tailscale
Get Team

What you get with AIBrain

CapabilityAIBrainTypical alternatives
Persistent memory Full API + vector + graph + satellites Partial or cloud-only
Agent/Task/Team composition Typed agents, sequential + hierarchical, delegation, guardrails Manual setup or limited
Flow engine Decorator-driven state machines with routing, persistence, HITL Build your own or use external tools
Document ingestion 7 formats, sentence-aware chunking, incremental Separate tools required
Universal MCP client 3 transports, tool bridging, registry Single protocol or none
Self-learning workflows 71 included Build your own
Self-improvement / evolution Full engine Not available
Multi-agent companies CEO, managers, workers, 8 LLM adapters Basic multi-agent or cloud-only
Dashboard / UI 45+ pages, fully local Cloud UI or none
MCP servers 9 servers (15 built-in tools) 0-1 servers
Knowledge graph Interactive force-directed Rare
100% local / private Yes β€” your machine, your data Often cloud-dependent
Research-backed retrieval SelRoute (arXiv-published) Standard retrieval

Get started now

One line. Copy it. Run it.

pip install aibrain
Then run: aibrain setup
Free. Python 3.10+ Β· Windows, macOS, Linux.
Native desktop app returning in v3 β€” the CLI and API are the stable shipping path today.
Windows PowerShell one-liner (wraps pip)
irm https://myaibrain.org/install.ps1 | iex
Mac / Linux / WSL one-liner (wraps pip)
curl -fsSL https://myaibrain.org/install.sh | bash
PyPI  ·  Docs  ·  Support