MCPcopy
hub / github.com/HKUDS/nanobot

github.com/HKUDS/nanobot @v0.2.2 sqlite

repository ↗ · DeepWiki ↗ · release v0.2.2 ↗
10,809 symbols 49,077 edges 555 files 3,094 documented · 29%
README

nanobot README cover

<a href="https://nanobot.wiki/docs/latest/getting-started/nanobot-overview">English</a> |
<a href="https://nanobot.wiki/cn/docs/latest/getting-started/nanobot-overview">简体中文</a> |
<a href="https://nanobot.wiki/zh-Hant/docs/latest/getting-started/nanobot-overview">繁體中文</a> |
<a href="https://nanobot.wiki/es/docs/latest/getting-started/nanobot-overview">Español</a> |
<a href="https://nanobot.wiki/fr/docs/latest/getting-started/nanobot-overview">Français</a> |
<a href="https://nanobot.wiki/id/docs/latest/getting-started/nanobot-overview">Bahasa Indonesia</a> |
<a href="https://nanobot.wiki/ja/docs/latest/getting-started/nanobot-overview">日本語</a> |
<a href="https://nanobot.wiki/ko/docs/latest/getting-started/nanobot-overview">한국어</a> |
<a href="https://nanobot.wiki/ru/docs/latest/getting-started/nanobot-overview">Русский</a> |
<a href="https://nanobot.wiki/vi/docs/latest/getting-started/nanobot-overview">Tiếng Việt</a>






<a href="https://pypi.org/project/nanobot-ai/"><img src="https://img.shields.io/pypi/v/nanobot-ai" alt="PyPI"></a>
<a href="https://pepy.tech/project/nanobot-ai"><img src="https://static.pepy.tech/badge/nanobot-ai" alt="Downloads"></a>
<img src="https://img.shields.io/badge/python-≥3.11-blue" alt="Python">
<img src="https://img.shields.io/badge/license-MIT-green" alt="License">
<a href="https://github.com/HKUDS/nanobot/graphs/commit-activity" target="_blank">
    <img alt="Commits last month" src="https://img.shields.io/github/commit-activity/m/HKUDS/nanobot?labelColor=%20%2332b583&color=%20%2312b76a"></a>
<a href="https://github.com/HKUDS/nanobot/issues?q=is%3Aissue%20is%3Aclosed" target="_blank">
    <img alt="Issues closed" src="https://img.shields.io/github/issues-search?query=repo%3AHKUDS%2Fnanobot%20is%3Aissue%20is%3Aclosed&label=issues%20closed&labelColor=%20%237d89b0&color=%20%235d6b98"></a>
<a href="https://twitter.com/intent/follow?screen_name=nanobot_project" target="_blank">
    <img src="https://img.shields.io/twitter/follow/nanobot_project?logo=X&color=%20%23f5f5f5" alt="follow on X(Twitter)"></a>
<a href="https://nanobot.wiki/docs/latest/getting-started/nanobot-overview"><img src="https://img.shields.io/badge/Docs-nanobot.wiki-blue?style=flat&logo=readthedocs&logoColor=white" alt="Docs"></a>
<a href="https://github.com/HKUDS/nanobot/raw/v0.2.2/COMMUNICATION.md"><img src="https://img.shields.io/badge/Feishu-Group-E9DBFC?style=flat&logo=feishu&logoColor=white" alt="Feishu"></a>
<a href="https://github.com/HKUDS/nanobot/raw/v0.2.2/COMMUNICATION.md"><img src="https://img.shields.io/badge/WeChat-Group-C5EAB4?style=flat&logo=wechat&logoColor=white" alt="WeChat"></a>
<a href="https://discord.gg/MnCvHqpUGB"><img src="https://img.shields.io/badge/Discord-Community-5865F2?style=flat&logo=discord&logoColor=white" alt="Discord"></a>

🐈 nanobot is an open-source, ultra-lightweight personal AI agent you can truly own. It keeps the agent core small and readable while giving you the practical pieces for real long-running work: WebUI, chat channels, tools, memory, MCP, model routing, automation, and deployment.

Start Here

You want to... Go to
Install nanobot with no terminal/config background Start Without Technical Background
Install quickly and get one CLI reply Install and Quick Start
Open the bundled browser UI after the CLI works WebUI
Connect Telegram, Discord, WeChat, Slack, Email, or another chat app Chat Apps
Configure providers, fallback models, Langfuse, MCP, web tools, or security Docs and Configuration
Understand or extend the internals Architecture and Development

Open Source Partners

Kimi Open Source Friends

MiniMax

📢 News

  • 2026-06-20 💬 Telegram rich messages, safer SDK concurrency, smoother Quick Start.
  • 2026-06-19 🔎 Firecrawl app, OpenAI image edits, safer session deletion.
  • 2026-06-18 💬 Feishu recovery, Keenable search, Mistral polish, workspace-aware git.
  • 2026-06-17 🧠 Default idle auto-compact, clearer /dream, macOS installer fixes.
  • 2026-06-16 🎯 Fresher goal context, Kimi K2.7 thinking, cleaner API retries.
  • 2026-06-15 📱 Mobile WebUI polish, optional file tools, real API usage.
  • 2026-06-14 🖼️ Themed cover, partner links, stronger Codex image streaming.
  • 2026-06-13 🗓️ Session-bound automations, sturdier WhatsApp, faster WebUI startup.
  • 2026-06-12 💬 Slack allowlisted channels can require mentions.
  • 2026-06-11 ✂️ Fenced-code message splitting.

Earlier news

  • 2026-06-10 📜 Segmented transcripts, Exa/Bocha search, StepFun/SiliconFlow ASR.
  • 2026-06-09 🎙️ Shared voice input, more STT providers, TeX and email polish.
  • 2026-06-08 🧮 Token heatmap fix, safer MCP HTTP probing, docs cleanup.
  • 2026-06-06 🧰 SDK MCP cleanup, removable OpenAI image defaults.
  • 2026-06-05 🖼️ Azure AAD, custom image providers, /skill, steadier pairing.
  • 2026-06-04 🔌 MCP reconnects, uv pip install fallback, QQ pairing.
  • 2026-06-03 🧠 Hidden-history recovery, quieter email progress handling.
  • 2026-06-02 📬 Email attachments, Napcat QQ, Volcengine search, simpler Dream.
  • 2026-06-01 🚀 Released v0.2.1The Workbench Release turns the packaged WebUI into a daily agent workbench: clearer Thought/response timelines, live file-edit activity, project workspaces, model and context controls, steadier sustained goals, CLI Apps + MCP extensions, and broader provider/channel support. Please see release notes for details.
  • 2026-05-30 🔐 Safer Matrix verification, bounded media downloads, clearer WebUI model timeline.
  • 2026-05-29 🧩 Extension registry, context-window tuning, document extraction controls.
  • 2026-05-28 🗂️ Project workspaces, access controls, steadier goals and streaming.
  • 2026-05-27 ⏱️ Codex streams respect idle timeouts during long runs.
  • 2026-05-26 📡 Telegram webhooks, refreshed Kagi search, cleaner transport errors.
  • 2026-05-25 🔌 Unified CLI Apps and MCP, Step Plan support, steadier sustained goals.
  • 2026-05-24 🧰 MCP presets, richer slash actions, configurable OpenAI-compatible requests.
  • 2026-05-23 🖼️ Zhipu image generation, longer exec windows, cleaner transcription config.
  • 2026-05-22 🛠️ CLI Apps, more image providers, safer web redirects and edits.
  • 2026-05-21 ⚡ Novita provider, faster sidebar, smoother coding tools and Weixin replies.
  • 2026-05-20 📶 Signal channel, faster gateway startup, multilingual README links.
  • 2026-05-19 🎨 Image provider registry, StepFun and Skywork, stronger WebUI controls.
  • 2026-05-18 🖌️ Gemini and MiniMax images, Ant Ling, live file-edit activity.
  • 2026-05-17 🌊 Smoother WebUI streaming, AutoCompact fixes, buffered CLI reasoning.
  • 2026-05-16 🧠 Atomic Chat provider, goal-aware timeouts, safer exec URL handling.
  • 2026-05-15 🚀 Released v0.2.0/goal holds sustained objectives across turns, WebUI now ships inside the wheel, image generation end to end, 5 new providers with fallback_models, and a real agent-loop refactor. Please see release notes for details.
  • 2026-05-14 🎯 /goal for long-term objectives, visible multi-step progress, long-horizon missions in chat.
  • 2026-05-13 🧠 Streaming reasoning before answers, automatic backup models, smoother plug-in reconnects.
  • 2026-05-12 🎛️ Saved model presets with WebUI badge, simpler plug-in tools, quieter Feishu topic threads.
  • 2026-05-11 🖥️ NVIDIA NIM support, terminal bot name and icon, streamed reasoning and MiMo toggle clarity.
  • 2026-05-09 🖼️ Sharper image replay, BYO web-search keys in Settings, Feishu threads routed cleanly.
  • 2026-05-08 ✨ Inline chat image, redesigned Settings and keys, Dream memory aligned with visible history.
  • 2026-05-07 📜 Locale-aware slash palette in WebUI, LAN login, faithful HTTP streaming responses.
  • 2026-05-06 🧩 Tunable tool hint, steadier voice and plug-in startups, schedules and reminders that stick.
  • 2026-05-05 🛡️ Quiet deny for unknown Telegram chats, Dream cleanup, fuller automation summaries.
  • 2026-05-04 🔐 Safer DingTalk outbound media links, durable cron persistence, DeepSeek polish.
  • 2026-05-03 ⚙️ Predictable shell allow-list behavior, isolated chats mid-reply, cleaner interactive retries.
  • 2026-05-02 🐈 LongCat support, smarter token sizing hints, clearer bundled upgrade guidance.
  • 2026-05-01 ☁️ Native AWS Bedrock provider, tighter helper handoffs and scoped session files.
  • 2026-04-30 💬 Feishu threads that honor replies and topics, WhatsApp bridge refresh on source edits.
  • 2026-04-29 🚀 Released v0.1.5.post3 — Smarter threads on Feishu, Discord, Slack, and Teams; DeepSeek-V4; Hugging Face & Olostep; choices, /history, and steadier long chats. Please see release notes for details.
  • 2026-04-28 🌐 Olostep web search, Hugging Face provider, safer workspace-tool interruptions.
  • 2026-04-27 💬 /history command, smarter session replay caps, smoother Discord / Slack threads.
  • 2026-04-26 🧭 Natural cron reminders, thread-aware restarts, safer local provider and shell behavior.
  • 2026-04-25 🧩 ask_user choices, macOS LaunchAgent deployment, MSTeams stale-reference cleanup.
  • 2026-04-24 🎥 Video attachments for channels, DeepSeek thinking control, faster document startup.
  • 2026-04-23 🧵 Discord thread sessions, Telegram inline buttons, structured tool progress updates.
  • 2026-04-22 🔎 GitHub Copilot GPT-5 / o-series support, configurable web fetch, WebUI image uploads.
  • 2026-04-21 🚀 Released v0.1.5.post2 — Windows & Python 3.14 support, Office document reading, SSE streaming for the OpenAI-compatible API, and stronger reliability across sessions, memory, and channels. Please see release notes for details.
  • 2026-04-20 🎨 Kimi K2.6 support, Telegram long-message split, WebUI typography & dark-mode polish.
  • 2026-04-19 🌐 WebUI i18n locale switcher, atomic session writes with auto-repair.
  • 2026-04-18 🧪 Initial WebUI chat, smarter setup wizard menus, WebSocket multi-chat multiplexing.
  • 2026-04-17 🪟 Windows & Python 3.14 CI, Dream line-age memory, email self-loop guard.
  • 2026-04-16 📡 SSE streaming for OpenAI-compatible API, Discord channel allow-list.
  • 2026-04-15 🎛️ LM Studio & nullable API keys, MiniMax thinking endpoint, runtime SelfTool.
  • 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 📓 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.
  • 2026-04-04 🚀 Jinja2 response templates, Dream memory hardened, smarter retry handling.
  • 2026-04-03 🧠 Xiaomi MiMo provider, chain-of-thought reasoning visible, Telegram UX polish.
  • 2026-04-02 🧱 Long-running tasks run more reliably — core runtime hardening.
  • 2026-04-01 🔑 GitHub Copilot auth restored; stricter workspace paths; OpenRouter Claude caching fix.
  • 2026-03-31 🛰️ WeChat multimodal alignment, Discord/Matrix polish, Python SDK facade, MCP and tool fixes.
  • 2026-03-30 🧩 OpenAI-compatible API tightened; composable agent lifecycle hooks.
  • 2026-03-29 💬 WeChat voice, typing, QR/media resilience; fixed-session OpenAI-compatible API.
  • 2026-03-28 📚 Provider docs refresh; skill template wording fix.
  • 2026-03-27 🚀 Released v0.1.4.post6 — architecture decoupling, litellm removal, end-to-end streaming, WeChat channel, and a security fix. Please see release notes for details.
  • 2026-03-26 🏗️ Agent runner extracted and lifecycle hooks unified; str

Extension points exported contracts — how you extend this code

InboundMessage (Interface)
(no doc)
bridge/src/whatsapp.ts
ImageLightboxProps (Interface)
(no doc)
webui/src/components/ImageLightbox.tsx
WhatsAppClientOptions (Interface)
(no doc)
bridge/src/whatsapp.ts
NavButtonProps (Interface)
(no doc)
webui/src/components/ImageLightbox.tsx
SendCommand (Interface)
(no doc)
bridge/src/server.ts
MessageBubbleProps (Interface)
(no doc)
webui/src/components/MessageBubble.tsx
SendMediaCommand (Interface)
(no doc)
bridge/src/server.ts
ReasoningBubbleProps (Interface)
(no doc)
webui/src/components/MessageBubble.tsx

Core symbols most depended-on inside this repo

get
called by 1874
nanobot/sdk/clients.py
append
called by 1359
nanobot/webui/transcript.py
get
called by 472
nanobot/agent/tools/file_state.py
tx
called by 374
webui/src/components/settings/SettingsView.tsx
cn
called by 260
webui/src/lib/utils.ts
split
called by 177
nanobot/channels/feishu.py
add
called by 129
nanobot/cli/commands.py
emit
called by 119
nanobot/sdk/streaming.py

Shape

Function 5,500
Method 4,277
Class 875
Interface 154
Route 3

Languages

Python90%
TypeScript10%

Modules by API surface

tests/channels/test_signal_channel.py196 symbols
tests/agent/test_onboard_logic.py192 symbols
webui/src/components/settings/SettingsView.tsx165 symbols
tests/cli/test_commands.py153 symbols
tests/channels/test_telegram_channel.py135 symbols
tests/agent/tools/test_self_tool.py132 symbols
tests/channels/test_matrix_channel.py126 symbols
tests/channels/test_channel_plugins.py121 symbols
tests/channels/test_websocket_channel.py119 symbols
tests/providers/test_litellm_kwargs.py102 symbols
nanobot/webui/transcript.py101 symbols
tests/tools/test_mcp_tool.py99 symbols

Dependencies from manifests, versioned

@eslint/js10.0.1 · 1×
@radix-ui/react-alert-dialog1.1.4 · 1×
@radix-ui/react-dialog1.1.4 · 1×
@radix-ui/react-dropdown-menu2.1.4 · 1×
@radix-ui/react-separator1.1.1 · 1×
@radix-ui/react-slot1.1.1 · 1×
@tailwindcss/typography0.5.19 · 1×
@testing-library/react16.1.0 · 1×
@testing-library/user-event14.5.2 · 1×
@types/node20.14.0 · 1×

For agents

$ claude mcp add nanobot \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact