Open Source • Local First

Your Personal AI Agent Architecture

A multi-process AI platform with type-safe IPC and capability-graph execution. Heavy tasks handled locally on your machine.

Deploy Locally View on GitHub

Built for Heavy Lifting

Unlike standard chatbots, ManBot is designed for complex tasks requiring research, multi-step execution, and deep reasoning.

🚀

Multi-Agent Pipeline

Planner → Task Memory → Executor → Critic. A sophisticated loop that ensures high-quality results for complex goals.

🕸️

Capability Graph (DAG)

Tasks are decomposed into Directed Acyclic Graphs, allowing parallel execution of LLM nodes, RAG lookups, and tools.

📦

Type-Safe IPC

Robust multi-process architecture using JSONL over stdin/stdout with Zod-validated envelopes for absolute reliability.

🧠

Session-Scoped RAG

Smart memory management with semantic search. Prevents context leakage between tasks while maintaining persistence.

📎

Deep File Ingest

OCR for images, Whisper for audio, and intelligent chunking for documents—all processed locally on your hardware.

⏰

Intelligent Reminders

Natural language parsing for recurring or one-time reminders. Managed via a dedicated Cron service.

🧩

Extensible Skills

Easily expand your agent's capabilities. Use community skills from our official repo or build your own.

system-architecture.mermaid

graph TD
    A[Telegram] --> B[Orchestrator]
    B --> C[Planner Agent]
    C --> D[Capability Graph]
    D --> E[Executor Agent]
    E --> F[Tool Host]
    E --> G[RAG Service]
    E --> H[Ollama]
    F --> I[Browser/Shell/File]

Orchestrating Intelligence

ManBot isn't just an LLM wrapper. It's an entire ecosystem of specialized services working in harmony.

Planner: Decomposes complex goals into actionable DAG nodes.
Executor: Runs nodes using local tools and models.
Critic: Inspects results and triggers revisions if necessary.
Task Memory: Maintains a graph-based history of all intelligent operations.

Monitor Everything

See What Your Agent Does

A clean, real-time internal dashboard for tracking tasks, system stats, and live event logs. Stay in control of your agent's reasoning.

Ready to claim your digital twin?

Install ManBot locally in minutes. All you need is Node.js and Ollama.

                    git clone https://github.com/larchanka/manbot.git
cd manbot
npm install && npm run build
npm run start:orchestrator
                

Documentation