HKUDS/nanobot

这是什么？

核心功能

• 01浏览器 WebUI 与终端客户端共享同一本地网关和已保存的会话
• 02支持 Telegram、Discord、Slack、微信、邮件、Mattermost 等聊天应用接入
• 03内置读取 PDF、Word、Excel、PowerPoint 文件的工具，并支持 shell 与网页搜索
• 04会话历史与长期记忆保存在智能体工作区中
• 05支持 MCP 集成、多智能体委派和定时自动化
• 06提供 Python SDK 与兼容 OpenAI 的 API，便于集成到自己的应用

适用场景

• 在自有服务器上部署私人 AI 助手，并通过 Telegram 或 Discord 与其聊天
• 让智能体读取项目文件夹，用于总结本地报告或文档
• 设置定时任务，由智能体执行后通过聊天应用返回结果
• 通过 SDK 或 HTTP API 为自己的 Python 应用接入智能体后端

快速上手

1. 1

   使用 uv 安装稳定版软件包

   uv tool install nanobot-ai
2. 2

   打开 WebUI 完成首次浏览器设置

   nanobot webui
3. 3

   在“设置 → 模型”中，使用你的凭证或支持的登录方式保存一个模型服务商或模型预设

使用前须知

• !你需要可用的受支持模型服务商或本地模型服务器，模型费用或硬件成本需自行承担。
• !需要 Python 3.11 或更高版本。
• !原生终端界面仅随 macOS、glibc Linux 和 Windows x64 的预编译安装包提供；其他平台请使用 WebUI 或 --classic。

标签

常见问题

nanobot 是什么？

可自托管的 Python 个人 AI 智能体框架，提供浏览器 WebUI、终端客户端、聊天应用接入、记忆与 MCP 支持。 nanobot 是一个用 Python 编写的轻量级、可自托管的个人 AI 智能体。你可以把它部署在自己的电脑或服务器上，通过浏览器 WebUI、终端客户端，或 Telegram、Discord、Slack、微信、邮件、Mattermost 等聊天应用使用。模型由你自行配置的服务商提供，包括兼容 OpenAI 接口的 API 和本地模型服务。

nanobot 可以免费使用吗？用的什么许可证？

nanobot 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

nanobot 还在维护吗？

活跃维护中。nanobot 最近一次提交是在 2026年10月20日。

nanobot 适合用来做什么？

在自有服务器上部署私人 AI 助手，并通过 Telegram 或 Discord 与其聊天 让智能体读取项目文件夹，用于总结本地报告或文档 设置定时任务，由智能体执行后通过聊天应用返回结果 通过 SDK 或 HTTP API 为自己的 Python 应用接入智能体后端

nanobot 怎么安装和运行？

使用 uv 安装稳定版软件包: uv tool install nanobot-ai 打开 WebUI 完成首次浏览器设置: nanobot webui 在“设置 → 模型”中，使用你的凭证或支持的登录方式保存一个模型服务商或模型预设

在哪里获取 nanobot？

源代码和安装说明在 GitHub 上：https://github.com/HKUDS/nanobot