HKUDS/nanobot

⭐ 42,124 · Python · GitHub 仓库

🐈 nanobot：超轻量级个人AI代理

ai ai-agent ai-agents anthropic chatgpt claude claude-code codex

一句话总结

超轻量级、开源的个人AI代理，可跨任何聊天平台持续运行，且资源开销极低。

🔥 核心能力与独特卖点

多通道全覆盖：开箱即用集成 10+ 平台（飞书、Discord、Slack、Teams、Telegram、微信、QQ、WebSocket、WebUI）。彻底解决团队或社区为每个通讯工具维护独立机器人的痛点。
通用LLM无锁定：支持所有主流提供商（OpenAI、Anthropic/Claude、DeepSeek、Gemini、Ollama、LM Studio、GitHub Copilot 等）。消除供应商锁定，可根据成本、延迟或能力需求热切换模型。
梦幻两级记忆系统：实现基于Token的记忆机制，包含上下文压缩与自动修复，支持真正意义上的长对话。解决了困扰大多数轻量级代理的“10条消息后代理就失忆”的顽疾。
原生MCP支持：将MCP资源和提示暴露为工具，实现与不断增长的MCP生态系统的集成。无需修改核心代码即可保持代理的可扩展性。
生产级部署路径：包含交互式设置向导、定时提醒、macOS LaunchAgent 自动启动和沙箱化Shell执行。通过提供从本地开发到始终在线代理的清晰路径，解决了“在我机器上能跑”的鸿沟。

独特卖点：nanobot 是唯一将超轻量级代码（可读、可破解的核心循环）与生产级多通道支持及精密的记忆系统相结合的代理——全部代码体积不到5MB Python。

Architecture

技术架构

组件	技术/方法
语言	Python ≥3.11
LLM SDK	原生 OpenAI 和 Anthropic SDK（无 litellm 抽象层）
代理核心	可组合的生命周期，含钩子、代理运行器、统一通道登录 CLI
流式传输	针对 OpenAI 兼容 API 的 SSE 流式传输，WebSocket 多通道多路复用
持久化	会话持久化，支持跨通道会话统一
插件系统	通过插件架构实现模块化命令和技能
安全性	沙箱化Shell执行，生产级输入清理

该架构优先考虑简洁性和可读性而非抽象化。核心代理循环刻意保持小巧，使其易于理解、调试和扩展。原生SDK的使用意味着相比元框架，依赖更少、响应速度更快。

快速入门指南

bash

# 安装 nanobot
pip install nanobot

# 运行交互式设置向导
nanobot init

# 启动代理
nanobot run

# 或直接指定通道
nanobot run --channel telegram

设置逻辑：安装后，运行 nanobot init 配置您的LLM提供商（例如 OpenAI API 密钥）和所需通道。该向导会自动检测环境变量，并引导您完成 Slack 和 Discord 等平台的 OAuth 设置。配置完成后，nanobot run 即可启动具有持久化内存和多通道支持的代理。

优点、缺点与用例

优点

真正的轻量级：依赖最少，安装快速，内存占用低（空闲时约50MB RAM）
多通道原生设计：并非事后诸葛——通道是一等公民
积极开发中：频繁发布（每周）、维护者响应迅速、社区不断壮大
MIT 许可证：个人和商业使用均免费，无任何限制
优秀的文档：README 内容详尽，包含架构图和配置示例

缺点

需要 Python ≥3.11：可能排除使用旧版本 Python 或遗留系统的用户
项目尚年轻：2026年初首次发布；部分功能（如 WebUI）仍在完善中
配置复杂度：设置多个通道需要单独的 OAuth 凭证和特定于平台的配置
无移动客户端：移动端访问依赖现有聊天应用（如 Telegram、微信）

谁不适合使用？

需要 RBAC、审计日志和合规功能的企业团队：nanobot 专为个人/小团队使用设计，不适合企业治理
使用 Python ❤️.11 的用户：代码库使用了现代 Python 特性，无法在旧版本上运行
想要无代码 AI 代理的用户：nanobot 需要终端访问和基本配置；它面向开发者
需要集中式、托管代理服务的团队：这是一个自托管工具，而非 SaaS 产品

理想用例

个人效率助手：一个持久化代理，跟随您穿梭于 Telegram、Slack 和 Discord 之间，管理任务、回答问题并执行命令
Claude Code/Codex 的开源替代品：适用于希望拥有可定制、自托管编码助手且无供应商锁定的开发者
社区机器人：在您社区的 Discord、Telegram 和飞书频道上部署单一代理，实现统一记忆和上下文
研究助手：运行长期实验，代理可在数天或数周内保持上下文，并具备自动记忆压缩功能
家庭自动化中枢：将 nanobot 连接到本地 LLM（通过 Ollama）和 MCP 服务器，通过聊天控制智能家居设备

社区与活跃度

拥有 42,124 颗星且持续增长，nanobot 显然在 AI 代理社区中引起了强烈共鸣。该项目处于积极开发状态（上次更新于 2026 年 5 月），发布和迭代节奏稳定。维护者在 Discord、微信和飞书上响应非常迅速，GitHub Issues 部分也展现了深思熟虑的讨论和快速的 Bug 修复。

社区正在快速增长，贡献者不断添加新的通道集成、MCP 服务器支持和插件扩展。该项目的势头表明，它正迅速成为个人 AI 代理的首选开源方案——就像 Homebrew 成为 macOS 包管理标准一样。如果您正在使用 AI 代理进行开发，这是一个值得关注（并加星）的项目。

HKUDS/nanobot ​

一句话总结 ​

🔥 核心能力与独特卖点 ​

技术架构 ​

快速入门指南 ​

优点、缺点与用例 ​

优点 ​

缺点 ​

谁不适合使用？ ​

理想用例 ​

社区与活跃度 ​