🐈 nanobot is an open-source and ultra-lightweight AI agent in the spirit of OpenClaw, Claude Code, and Codex. It keeps the core agent loop small and readable while still supporting chat channels, memory, MCP and practical deployment paths, so you can go from local setup to a long-running personal agent with minimal overhead.

• 2026-04-14 🚀 Released v0.1.5.post1 — Dream skill discovery, mid-turn follow-up injection, WebSocket channel, and deeper channel integrations. Please see release notes for details.
• 2026-04-13 🛡️ Agent turn hardened — user messages persisted early, auto-compact skips active tasks.
• 2026-04-12 🔒 Lark global domain support, Dream learns discovered skills, shell sandbox tightened.
• 2026-04-11 ⚡ Context compact shrinks sessions on the fly; Kagi web search; QQ & WeCom full media.
• 2026-04-10 📓 Notebook editing tool, multiple MCP servers, Feishu streaming & done-emoji.
• 2026-04-09 🔌 WebSocket channel, unified cross-channel session, disabled_skills config.
• 2026-04-08 📤 API file uploads, OpenAI reasoning auto-routing with Responses fallback.
• 2026-04-07 🧠 Anthropic adaptive thinking, MCP resources & prompts exposed as tools.
• 2026-04-06 🛰️ Langfuse observability, unified Whisper transcription, email attachments.
• 2026-04-05 🚀 Released v0.1.5 — sturdier long-running tasks, Dream two-stage memory, production-ready sandboxing and programming Agent SDK. Please see release notes for details.

• Ultra-lightweight: stable long-running agent behavior with a small, readable core.
• Research-ready: the codebase is intentionally simple enough to study, modify, and extend.
• Practical: chat channels, API, memory, MCP, and deployment paths are already built in.
• Hackable: you can start fast, then go deeper through repo docs instead of a monolithic landing page.

Install from source

git clone https://github.com/HKUDS/nanobot.git
cd nanobot
pip install -e .

Install with uv

uv tool install nanobot-ai

Install from PyPI

pip install nanobot-ai

1. Initialize

nanobot onboard

2. Configure (~/.nanobot/config.json)

Configure these two parts in your config (other options have defaults). Add or merge the following blocks into your existing config instead of replacing the whole file.

Set your API key (e.g. OpenRouter, recommended for global users):

{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-v1-xxx"
    }
  }
}

Set your model (optionally pin a provider — defaults to auto-detection):

{
  "agents": {
    "defaults": {
      "provider": "openrouter",
      "model": "anthropic/claude-opus-4-6"
    }
  }
}

3. Chat

nanobot agent

• Want different LLM providers, web search, MCP, security settings, or more config options? See Configuration
• Want to run nanobot in chat apps like Telegram, Discord, WeChat or Feishu? See Chat Apps
• Want Docker or Linux service deployment? See Deployment

1. Start the gateway

nanobot gateway

2. Start the webui dev server

cd webui
bun install
bun run dev

🐈 nanobot stays lightweight by centering everything around a small agent loop: messages come in from chat apps, the LLM decides when tools are needed, and memory or skills are pulled in only as context instead of becoming a heavy orchestration layer. That keeps the core path readable and easy to extend, while still letting you add channels, tools, memory, and deployment options without turning the system into a monolith.

Browse the repo docs for the latest features and GitHub development version, or visit nanobot.wiki for the stable release documentation.

• Talk to your nanobot with familiar chat apps: Chat Apps
• Configure providers, web search, MCP, and runtime behavior: Configuration
• Integrate nanobot with local tools and automations: OpenAI-Compatible API · Python SDK
• Run nanobot with Docker or as a Linux service: Deployment

PRs welcome! The codebase is intentionally small and readable. 🤗

Unsure which branch to target? See CONTRIBUTING.md for details.

Roadmap — Pick an item and open a PR!

• Multi-modal — See and hear (images, voice, video)
• Long-term memory — Never forget important context
• Better reasoning — Multi-step planning and reflection
• More integrations — Calendar and more
• Self-improvement — Learn from feedback and mistakes

Thanks for visiting ✨ nanobot!