HKUDS/nanobot

Ultra-lightweight, open-source, self-hosted personal AI agent framework in Python with WebUI, tools, memory, MCP, multi-agent workflows, automation, and chat apps

它解決了什麼問題

nanobot 是一個自行託管、超輕量的個人 AI 代理執行環境。它解決了在不依賴大型平台的情況下擁有與控制自己的 AI 代理的問題,提供一個小巧、易讀的核心,並可透過各種工具與頻道擴充。

它如何運作

此專案的核心是一個小型代理迴圈,會將來自各種聊天應用程式的訊息交給 LLM 處理。LLM 會決定何時使用工具,而記憶或技能則以上下文的形式被拉入,而非作為沉重的協調層。它支援廣泛的提供者(相容 OpenAI 的 API、本地 LLM 透過 Ollama 或 vLLM),且可部署為長時間執行的閘道。

適用對象

此工具設計給想要真正擁有個人 AI 代理的使用者,從沒有技術背景者(透過引導式教學)到想要透過 Python SDK 或相容 OpenAI 的 API 整合代理的開發者皆適用。

重點特色

  • 多頻道支援:可連接 Telegram、Discord、Slack、WeChat、Email、Mattermost,以及內建的 WebUI。
  • 可擴充工具集:支援檔案、Shell、網路搜尋、網路抓取、MCP、Cron 與影像生成。
  • 永續工作流程:具備長期記憶(透過 Dream)、會話歷史與排程自動化。
  • 模型自由:支援相容 OpenAI 的 API 與本地 LLM,提供模型路由與備援選項。
  • 簡易部署:一鍵部署至 Render,或透過 PyPI/uv 於本機安裝。