AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
Multi-Agent/
nanobot
nanobot logo

nanobot

Active·★ 50.3k·MIT·Updated 2026-11-21
★ Most Popular★ Essential

nanobot, from the HKU Data Intelligence Lab (HKUDS), is an ultra-lightweight, self-hosted personal AI agent framework written in Python. It runs in a browser WebUI, in the terminal or inside chat apps, and combines tools, long-term memory, MCP integrations, model routing, subagents and scheduled automations around a deliberately small, readable core.

It suits individuals and small teams who want their own always-on assistant without adopting a large platform. Typical uses include chatting with an assistant from Telegram, Discord, Slack, WeChat, Feishu, email or Linear; running long-horizon goals and recurring tasks; and giving the agent tools such as file access, shell, web search, image generation and MCP servers. It works with OpenAI-compatible APIs and local models, offers fallbacks between providers, and exposes a Python SDK and an OpenAI-compatible API for integrations.

Getting started: requires Python 3.11+. Run the one-command installer (or `pip install nanobot-ai`), then `nanobot webui` and choose a provider and model under Settings → Models. `nanobot gateway --background` keeps channels and automations running after you close the terminal.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-11-21.

License
MIT
Latest release
v0.4.2 · 2026-11-21
Last commit
2026-11-21
Contributors
504
Forks
8,759
Open issues and PRs
875
First published
2026-02-01

Source: GitHub, npm and PyPI public APIs.

#AI Agent Framework#Self-hosted#Python#Multi-Agent#WebUI#Long-term Memory#Workflow Automation#LLM Integration
$ Install
$ curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh
↗ Visit site★ GitHub
01

Features

01Persistent workflows: goals, memory, tools, and chat context survive long-running work.
02Chat-native reach: WebUI, API, Telegram, Feishu, Slack, Discord, Teams, email, and Mattermost.
03Model freedom: OpenAI-compatible APIs, local LLMs, image generation, search, and fallbacks.
04Small core: readable internals with MCP, memory, deployment, and automation built in.
05Own your stack: inspect, customize, self-host, and extend without a giant platform.
02

Why choose it

+Small, readable core that is easy to inspect, customise and self-host.
+Reaches you through a WebUI, terminal and many chat apps, including Feishu, WeChat and Linear.
+Model freedom with OpenAI-compatible APIs, local models and provider fallbacks.
+Long-term memory, scheduled automations and subagents built in; MIT licensed.
03

Trade-offs

!Giving a personal agent shell and file access on your machine requires careful choice of workspace and access mode.
!The project moves quickly; the source install carries the newest features but is less stable than the PyPI release.
!As a lightweight framework it has fewer enterprise features (team management, audit, managed hosting) than larger platforms.
05

Maintenance check

ActiveChecked: 2026-11-10
Last commit
2026-11-10
Commits, last 90 days
100+
Releases, last 90 days
3
Latest release
v0.4.1 (2026-11-06)
Open issues
874
Recent issues with at least one comment
4/12
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 96, 68, 90, 89, 120, 96, 130, 108, 132, 84, 74, 15

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

Most discussed open issues

  • #5266 Logs about token consumption (too many tokens are burned)15 comments · 2026-08-06
  • #2463 Architectural issue: nanobot does not preserve the exact prompt prefix it previously sent15 comments · 2026-03-25
  • #1955 是否能够或者应该支持在子 agent 执行的过程中,有方式可以看到子 agent 的执行过程?10 comments · 2026-03-13
  • #222 Multi agents setup - Supported ?10 comments · 2026-02-06
  • #5924 Agent gets stuck in sudo loop - becomes unusuable9 comments · 2026-09-26

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

04

Who it fits

Pick it if
  • You want a lightweight, hackable Python personal AI agent framework with clean code, a WebUI, and built-in MCP client support.
  • You prefer an easy-to-read, self-hosted agent core without the enterprise boilerplate of heavy agent frameworks.
Look elsewhere if
  • You require production-grade distributed state checkpointing, strict Pydantic type validation, or multi-role team SOPs; Pydantic AI or CrewAI offer more mature infrastructure.
  • Your production stack is .NET or Go; Microsoft Agent Framework covers those runtimes.
06

How it differs

Pydantic AI logovs Pydantic AI★ 21.3k

nanobot provides a full-stack personal agent app with WebUI, memory, and chat tools out of the box. Pydantic AI is a headless, type-safe Python library for embedding model loops into existing services.

Full comparison →
CrewAI logovs CrewAI★ 61.1k

nanobot is built as a lightweight personal assistant with a readable core. CrewAI is specialized in role-based multi-agent teams with deterministic Flows and structured task delegation.

Full comparison →
07

Compatibility

Python
Runtime
Verified via docs
MacOS
OS
Verified via docs
Linux
OS
Verified via docs
Windows
OS
Verified via docs
Docker
Deployment
Verified via docs
08

Quick start

1
$ curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh
09

Use cases

↳Running long-horizon goals and scheduled automations.
↳Connecting to various chat applications like Telegram, Discord, Slack for AI interaction.
↳Exposing a Python SDK and OpenAI-compatible API for custom integrations and development.
↳Deploying as a long-running local or server-side agent gateway.
10

Alternatives

⚡Top VS:
VSCrewAI★61.1k→VSPydantic AI★21.3k→VSoto-dock★202→VSOctoForge★22→
CrewAI logo
CrewAI★ 61.1k
Framework for orchestrating role-playing, autonomous AI agents. By working together, your Crew can tackle complex tasks.
VSCompare→
Pydantic AI logo
Pydantic AI★ 21.3k
GenAI Agent Framework, the Pydantic way. A Python agent framework designed for production with type safety at its core.
VSCompare→
oto-dock logo
oto-dock★ 202
The self-hosted platform for your company's AI agents. Your team builds them on Claude Code, Codex or local models, and they work in chats, on schedules, on the phone and on your own machines.
VSCompare→
OctoForge logo
OctoForge★ 22
Self-hosted multi-tenant agent platform for teams: skills, knowledge, API contracts and MCP servers live in the database and grow at runtime; big API responses are queried with SQL, not stuffed into context. Typed Python core (Protocol ports) you can embed in your own stack.
VSCompare→
nimblebrain logo
nimblebrain★ 28
Self-hosted platform for MCP Apps and agent automations — tools, interactive UIs, scheduled runs, multi-agent delegation.
VSCompare→
loomcycle logo
loomcycle★ 18
The runtime substrate for agentic systems — one Go binary, six LLM providers, MCP-native, configurable as a managed sandbox or full agentic dev environment. Where agents live, talk, and learn.
multica logo
multica★ 57.0k
Make humans and AI agents work as one team — open-source and self-hostable.
VSCompare→
PocketFlow logo
PocketFlow★ 11.3k
Pocket Flow: 100-line LLM framework. Let Agents build Agents!
VSCompare→
See all alternatives →

Featured in these lists

  • Open-Source Multi-Agent Frameworks: CrewAI, Pydantic AI, Google ADK, Microsoft Agent Framework & More

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs05Maintenance check04Who it fits06How it differs07Compatibility08Quick start09Use cases10Alternatives
HKUDS /
nanobot
↗

Ultra-lightweight self-hosted personal AI agent framework

50.3k8.8kMIT
Last commit1d ago
StatusActive
CategoryMulti-Agent
Contributors504
Latest releasev0.4.2
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.