nanobot

安在自己电脑上的 AI 管家，随叫随到，指哪打哪

超轻量、开源、可自托管的个人 AI 智能体框架，基于 Python 构建，内置 WebUI、工具调用、记忆、MCP、多智能体工作流、自动化与聊天应用等能力，部署简单，是打造个人 AI 助手的理想底座。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 48488

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队HKUDS

所属国家

官网地址https://nanobot.wiki

GitHubhttps://github.com/HKUDS/nanobot

定价模式free

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent-framework,ai-agent,ai-agents,chatbot,chatops,discord-bot,llm-agents,llms,local-llm,mcp,model-context-protocol,multi-agent,openai-compatible,openclaw,personal-ai-assistant,python,self-hosted,telegram-bot-ai-assistant,webui,workflow-automation

GitHub 星标★ 48488

30天Star增速

HF 下载量

上线时间2026-02-01 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

Python 3.11 或更高版本
源码安装需要 Git 与 Bun（PyPI 安装不需要）
如需 pip 安装，建议使用虚拟环境以避免 externally-managed-environment 报错
首次运行需要准备可用的模型提供商凭据（API Key）

安装与启动步骤

1一键安装

macOS / Linux 下执行官方安装脚本，默认从 PyPI 安装或升级 nanobot-ai，并尽量避免系统级 pip 安装。
```
curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh
```
2Windows 安装

Windows 用户在 PowerShell 中执行官方安装脚本，效果与 macOS/Linux 安装脚本一致。
```
irm https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.ps1 | iex
```
3用 uv 安装

已安装 uv 的用户可用它安装稳定版；也可用 pipx install nanobot-ai 或 python -m pip install nanobot-ai 替代。
```
uv tool install nanobot-ai
```
4从源码安装

想体验最新特性时克隆仓库并以可编辑模式安装。Windows 请改用 .venvScriptsActivate.ps1 激活虚拟环境。
```
git clone https://github.com/HKUDS/nanobot.git
cd nanobot
python -m venv .venv
source .venv/bin/activate
python -m pip install -e .
```
5验证安装

确认命令行客户端已就绪。若提示命令不存在，说明 nanobot 不在 PATH，需用安装它的工具方式调用。
```
nanobot --version
```
6启动 WebUI

推荐的首次运行方式，会自动创建配置与工作区、启动本地网关并打开浏览器，首次访问无需先配置模型。
```
nanobot webui
```
7配置模型

在浏览器里打开 Settings → Models，选择提供商、凭据与模型，然后新建话题发送 Hello! 验证连通性。
8后台常驻

希望关闭终端后仍保持在线时使用。请先通过 nanobot webui 完成首次模型配置，再切到后台模式。
```
nanobot gateway --background
```

关键配置

配置项	必填	说明	示例
`provider`	是	在 WebUI 的 Settings → Models 中选择的模型提供商	`在 WebUI 列表中选取`
`credential`	是	对应提供商的 API 凭据，用于调用模型服务	`sk-xxxxxxxx`
`model`	是	实际使用的模型名称，与所选提供商匹配	`在 WebUI 列表中选取`

如何确认成功

执行 nanobot --version 能输出版本号；运行 nanobot webui 后打开 http://127.0.0.1:8765，发送 Hello! 收到正常回复即成功。

常见问题

Q：pip 报 externally-managed-environment 错误怎么办？

A：改用一键安装脚本、uv tool install nanobot-ai、pipx install nanobot-ai，或在虚拟环境中执行 pip 安装。

Q：提示 nanobot 命令不存在（不在 PATH）？

A：复用安装器打印的完整命令，或使用 uv tool run --from nanobot-ai nanobot ...、pipx run --spec nanobot-ai nanobot ...，也可用安装该包的 Python 解释器调用。

Q：想让 nanobot 在关闭终端后继续运行？

A：先用 nanobot webui 完成首次模型配置，再执行 nanobot gateway --background；之后可用 nanobot gateway status / logs / restart / stop 管理。

Q：可以直接在终端里用，不用浏览器吗？

A：可以。直接运行 nanobot 打开原生终端客户端，它与 WebUI 共享会话和本地网关；nanobot -m "Hello!" 可单次请求后退出。

Q：首次安装还没配置模型能启动吗？

A：可以。全新安装时 WebUI 可在配置模型前先打开，随后在浏览器里继续完成设置，而不必手改 JSON 配置文件。

注意事项

首次运行的 WebUI 默认只绑定 localhost，不会暴露到局域网。
源码安装需要额外安装 Git 和 Bun，且 git pull --ff-only 后如依赖有变需重跑 python -m pip install -e .。
安装器支持 --dry-run 预览安装计划，也可以先打开 scripts/install.sh 或 scripts/install.ps1 检查脚本内容。
终端客户端中可用 / 查看命令、/sessions 切换会话、@ 提及应用或 MCP 服务，用 Ctrl+V 或 Alt+V 粘贴图片。

核心亮点

超轻量级设计，核心代码简洁，适合快速部署和二次开发
内置WebUI、工具调用、记忆、MCP支持及多智能体工作流，功能全面
支持本地LLM和多种聊天平台（如Discord），自托管灵活性强

不足之处

文档/社区待观察

适用场景

个人知识库助手，本地部署处理私有数据
团队内部自动化流程，通过聊天机器人触发任务
快速原型开发，验证多智能体协作或MCP集成方案

替代项目

AutoGen、LangChain、CrewAI

项目介绍

nanobot 是智能体领域的开源项目，由 HKUDS 开发，是 2026 年新上线的项目。

在全站 13,090 个收录项目中，它的 GitHub 星标数（48,488）位列前 1%，在智能体分类的 2,517 个项目里位列前 1%。

近 42 天，它的 GitHub 星标从 46,895 增加到 48,488，净增 1,593。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。MIT许可证，完全免费，可自行部署使用。从国内网络环境看，可直接访问。

它主要面向的使用场景是：个人知识库助手，本地部署处理私有数据。同类可对比的替代方案包括 AutoGen、LangChain、CrewAI。

上一篇：Agent-Reach

下一篇：CowAgent