Python nanobot 超轻量可自托管的个人AI代理框架

AI 代理平台越做越重，要么绑定大厂账号，要么配置繁琐。nanobot 是香港大学 HKUDS 团队开源的个人 AI 代理框架，主打超轻量、自托管、可掌控自己的技术栈。它能在浏览器、终端或聊天应用里运行，帮你处理文件、记住偏好、安排任务，AI 能力来自你自己的模型提供商或本地模型服务。

项目基本信息

一、项目介绍

nanobot 是一个用 Python 编写的超轻量级、开源、自托管的个人 AI 代理框架。它可以在浏览器 WebUI 或终端原生 TUI 中运行，也能接入 Telegram、Discord、Slack、WeChat、Email、Mattermost、Linear 等渠道。它的核心是小——核心精简、内部实现可读，并且内置了 MCP、记忆、部署和自动化能力，不依赖大型平台。

二、核心优势

第一，自托管。你可以完全检查、定制、自托管和扩展，不把数据和服务交给巨型商业平台。第二，超轻量核心。代码可读、易扩展，维护门槛低。第三，多界面。浏览器 WebUI 或终端工作台任选。第四，聊天原生触达。通过多种消息渠道使用代理。第五，文件处理。内置工具读取 PDF、Word、Excel、PowerPoint。第六，工具集成。支持 shell、web search 或 fetch、MCP、cron、图像生成、多代理委派。第七，持久记忆。通过 Dream 保持会话历史和长期记忆，并支持长期目标和定时自动化。第八，开发接口。提供 Python SDK 和 OpenAI 兼容 API。

三、适用场景

想拥有一个完全自己掌控的 AI 助手的人最适合 nanobot：本地处理文件、长期记忆偏好、定时跑自动化任务。它也适合需要多渠道触达的场景——在微信、Slack、Telegram 里都能调起同一个代理。对担心供应商锁定的人，它支持 OpenAI 兼容 API、本地 LLM 和回退模型，模型选择自由。

四、安装教程

推荐用自动脚本安装（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：

uv tool install nanobot-ai
python -m pip install nanobot-ai

需要 Python 3.11 以上。常见报错多来自 Python 版本过低或虚拟环境未激活；开发版安装需要 Git 和 Bun。

五、使用示例

验证安装并打开界面：

nanobot --version
nanobot webui

终端向导初始化：

nanobot onboard --wizard

文件工作示例：把一个 notes.txt 副本放进练习文件夹，在 nanobot 中选择该文件夹并设为 Restricted 权限，然后发送 Read notes.txt and write a short summary to summary.md.，再打开生成的 summary.md 查看结果。单次回复可用 nanobot -m "Hello!" 验证。长期目标用 slash goal 下达，例如 slash goal Review this project's tests and list the smallest missing test case.。

六、常见问题

问：需要联网吗？答：AI 能力需要连接你配置的模型提供商或本地模型服务，框架本身可自托管。问：支持哪些模型？答：OpenAI 兼容 API、本地 LLM、图像生成、搜索及回退模型。问：能在哪些平台跑？答：macOS 13 以上、glibc 2.17 以上 Linux、Windows x64；其他平台可用 nanobot --classic 或 WebUI。问：记忆怎么持久化？答：通过 Dream 保持会话历史和长期记忆。

七、总结

nanobot 把个人 AI 代理这件事拉回到了用户自己手里：轻量、可读、自托管，又能多渠道触达和持久记忆。对于不想被大平台绑定、希望完全掌控数据和运行方式的开发者，它是一个很实在的选择。