+23
日增长
+149
周增长
+1,135
月增长
50,106
stars
8,750
forks
209
watchers
4,694
prs
1,605
issues
22
releases
README
English |
简体中文 |
繁體中文 |
Español |
Français |
Bahasa Indonesia |
日本語 |
한국어 |
Русский |
Tiếng Việt
Discord ·
X ·
WeChat 微信交流群 ·
Feishu
nanobot
🐈 nanobot is an ultra-lightweight, open-source, self-hosted personal AI agent framework written in Python. Use it in a browser, terminal, or chat app to work with files, remember preferences, and schedule tasks. Connect a supported model provider or local model server to supply the AI.
Start Here
| You want to... | Go to |
|---|---|
| Install nanobot with no terminal/config background | Start Without Technical Background |
| Install quickly and get your first reply | Install and Quick Start |
| Open the bundled browser UI | WebUI |
| Connect Telegram, Discord, WeChat, Slack, Email, Mattermost, Linear, or another channel | Chat app guide |
| Configure providers, fallback models, Langfuse, MCP, web tools, or security | Docs and Configuration |
| Develop the browser UI | Install current source, then WebUI development and Contributing |
| Integrate from Python | Python SDK |
| Understand or extend the internals | Architecture, Contributing, and Provider extensions |
| Deploy to the cloud or keep nanobot running as a service | Deployment |
What can nanobot do?
nanobot can:
- run in a browser WebUI or terminal
- connect to Telegram, Discord, Slack, WeChat, Email, Mattermost, Linear, and other channels
- read images, PDF, Word (.docx), Excel (.xlsx), and PowerPoint (.pptx) files with built-in file tools
- use shell, web search/fetch, MCP integrations, cron, image generation, and multi-agent delegation
- keep session history and use Dream to consolidate long-term memory
- run long-horizon goals and scheduled automations
- embed the agent with the Python SDK
- deploy as a long-running local or server-side agent gateway
💡 Why nanobot
- Persistent workflows: keep saved conversations, long-term memory, and task results for later work.
- Chat-native reach: WebUI, Telegram, Feishu, Slack, Discord, Teams, email, Mattermost, and Linear.
- Model freedom: OpenAI-compatible APIs, local LLMs, image generation, search, and fallbacks.
- Small core: readable internals with MCP, memory, deployment, and automation built in.
- Own your stack: inspect, customize, self-host, and extend without a giant platform.
📦 Install
You need Python 3.11 or newer and access to a supported model provider or local model server. Model fees or local hardware requirements depend on the service you choose; nanobot does not supply a model account.
Choose the stable release for everyday use or current source for development and the latest features. This README describes current source; published documentation covers the released version.
New to terminals or model credentials? Follow Start Without Technical Background. Updating an existing instance? Follow updates and recovery for your installation method, backup steps and restart checks.Top issues
#5266Logs about token consumption (too many tokens are burned)15 comments · 2026-08-06#2463Architectural issue: nanobot does not preserve the exact prompt prefix it previously sent14 comments · 2026-03-25#1955是否能够或者应该支持在子 agent 执行的过程中,有方式可以看到子 agent 的执行过程?10 comments · 2026-03-13#222Multi agents setup - Supported ?10 comments · 2026-02-06#5924Agent gets stuck in sudo loop - becomes unusuable9 comments · 2026-09-26#3292[Feature Request] Session-Level Focus Tool: Persistent Task Awareness Across Interruptions and Compaction9 comments · 2026-04-19#1300Matrix channel does not work9 comments · 2026-02-27#5000Proposal: evolve the current subagent system toward multi-agent collaboration7 comments · 2026-07-20
Discussions
#6675Toggle the WebUI build during the Docker build step0 comments · 2026-11-15#6665Chopper: a small open model that cuts only the needed sentences out of retrieved text0 comments · 2026-11-14#6618New sessions leak historical context from previous sessions0 comments · 2026-11-09#6599[Suggestion] Add a troubleshooting about sending images of feishu channel1 comments · 2026-11-08#6597Opens the Nanobot Agent web interface in the browser's sidebar.7 comments · 2026-11-07#6589What model ID should I use for image generation with codex account?1 comments · 2026-11-06#6551WhatsApp Agent Profile Management0 comments · 2026-11-03#6479Folders inside a project to classify chats0 comments · 2026-10-26
Latest release
v0.4.1 v0.4.1 2026-11-06Changes - Fix TLS certificate verification, sandboxed shell execution and workspace permissions for queued inputs. - Keep idle maintenance from blocking active work or incorrectly refusing an update. Improve retry, reconnection and recovery behavior, and preserve native provider state through compaction. - Add a file-context graph with file previews, local Markdown links and recent context snapshots. Switching topics keeps each conversation's context separate. - Share syntax highlighting across code, source previews and read-only diffs, with complete source copying and plain-text fallbacks. -