nanobot 个人 AI 智能体框架

nanobot 是什么

nanobot 是香港大学数据智能实验室（HKUDS）开源的超轻量自托管个人 AI 智能体框架，使用 Python 编写。它把「能干活」的智能体所需能力打包进一个可读性很强的小核心：浏览器 WebUI、终端、聊天应用三种入口，文件读写、Shell、联网搜索、MCP 集成、定时任务与多智能体委派等工具，以及会话历史与长期记忆。

模型侧不绑定厂商，接入任意 OpenAI 兼容 API 或本地模型服务即可，也可配置备用模型与图片生成、搜索等能力。

核心能力

• 多入口使用：内置 WebUI、终端 TUI，以及 Telegram、Discord、Slack、微信、飞书、邮件、Mattermost、Linear 等渠道。
• 文件与文档处理：内置工具可直接读取 PDF、Word、Excel、PowerPoint，用于报告摘要等任务。
• 工具与扩展：Shell、网页搜索/抓取、MCP、Cron、图像生成、多智能体协作。
• 记忆与长任务：通过 Dream 机制保存会话历史与长期偏好，支持长周期目标与定时自动化。
• 可集成：提供 Python SDK 与 OpenAI 兼容的 Agent API，方便嵌入自有系统。
• 可自托管：可作为长期运行的本地或服务器端智能体网关部署。

安装与上手

需要 Python 3.11 或更新版本，以及一个受支持的模型服务或本地模型服务器。官方提供一键安装脚本，会自动创建隔离的 Python 环境并引导配置：

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh

# Windows PowerShell
irm https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.ps1 | iex

也可以使用 uv 或 pip 安装 PyPI 上的稳定版；希望跟进最新特性时，可克隆源码以可编辑模式安装。安装完成后按引导配置模型，即可在 WebUI 中开始对话。

适合谁

• 想拥有一个数据自托管的个人 AI 助理，并把它接入日常聊天工具的开发者。
• 希望读懂并改造智能体内部机制（工具调用、记忆、MCP、多智能体）的学习者与研究者。
• 需要为团队搭建带长期记忆与定时任务的自动化工作流，并通过 API 集成的工程团队。

注意事项

nanobot 本身不提供模型账号，模型费用或本地算力需自行准备；渠道接入、MCP、部署等配置项较多，建议先阅读官方文档中的快速开始与配置章节。项目迭代较快，稳定版与源码版在行为上可能存在差异，生产使用前请做好备份与升级规划。