nanobot

项目简介

nanobot 是一个超轻量、开源、自托管的个人 AI 智能体框架，使用 Python 编写。你可以在浏览器 WebUI、终端或聊天应用中使用它处理文件、记住偏好并安排任务，由受支持的模型提供商或本地模型服务器提供 AI 能力。

核心功能

• 可在浏览器 WebUI 或终端中运行，并可连接 Telegram、Discord、Slack、微信、Email、Mattermost、Linear 等渠道。
• 内置文件工具可读取 PDF、Word、Excel 和 PowerPoint 文件，用于总结报告等任务。
• 支持 shell、网页搜索与抓取、MCP 集成、cron、图像生成和多智能体委派。
• 通过 Dream 保留会话历史和长期记忆，并支持长期目标和定时自动化。
• 通过 OpenAI 兼容 API、本地 LLM、图像生成、搜索和回退机制提供模型选择自由。
• 提供 Python SDK 和 OpenAI 兼容 API 用于集成，并可作为长期运行的本地或服务器端智能体网关部署。

适用场景

• 用并行智能体审查一次发布，分别覆盖代码、回归测试和发布风险，再把发现汇总成一份报告。
• 把客户反馈转化为 Linear 事项，并附上来源引述和验收标准。
• 安排晨间简报或每周回顾等重复工作，检查每次运行，并在原话题中查看结果。
• 读取 notes.txt 等本地文件并写一份简短摘要，或总结 PDF、Word、Excel 和 PowerPoint 报告。

快速开始

• 使用推荐安装器安装 nanobot，或在受管理的 Python 环境中运行 uv tool install nanobot-ai 或 python -m pip install nanobot-ai。
• 需要 Python 3.11 或更高版本，并能访问受支持的模型提供商或本地模型服务器。
• 运行 nanobot webui 进行浏览器设置，在设置中保存提供商/模型预设，新建话题并发送 Hello! 以验证模型连接。
• 仅终端设置可运行 nanobot onboard --wizard；nanobot -m "Hello!" 可检查一次回复，运行 nanobot 可打开交互式 TUI。

部署与要求

• 需要 Python 3.11 或更高版本，并能访问受支持的模型提供商或本地模型服务器。
• nanobot 不提供模型账户；模型费用或本地硬件要求取决于你选择的服务。
• 自托管指南涵盖 Docker、Docker Compose、Linux 服务和 macOS LaunchAgent 设置。
• Render 部署会要求 ANTHROPIC_API_KEY 和私有的 NANOBOT_WEB_TOKEN；持久磁盘需要付费的 Render 服务。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。