模型 / 資料集
HKUDS/nanobot avatar
HKUDS/nanobot

nanobot:一個自託管的個人 AI 智能體框架

適用於您的工具、聊天和工作流程的輕量級開源 AI 代理程式。

48,188 個 Star8,516 個 ForkPythonMIT

秒懂

它是什麼?
一個以 Python 撰寫的框架,支援 WebUI、終端、聊天應用、工具、記憶、MCP 與自動化。
適合誰用?
nanobot 被描述為一個小型核心的智能體執行環境,可從 PyPI 或原始碼安裝,在 WebUI、終端或聊天應用中執行,並透過工具、記憶與自動化擴充。README 未提供基準測試、安全稽核或生產支援細節,這些問題仍待驗證。
可以商用嗎?
可以。MIT 是寬鬆授權:你可以使用、修改並販售以它為基礎的軟體,只需保留著作權與授權聲明。
還在維護嗎?
有在維護。儲存庫在最近一天內有新的提交。
用什麼語言寫的?
主要是 Python(依據 GitHub 的語言統計)。

以上回答依據專案的 GitHub 資料(最近同步於 2026年9月15日)與我們的分析,不構成法律意見。

開源專案深度解析

自託管的智能體執行環境

nanobot 是一個以 Python 撰寫的開源個人 AI 智能體框架,README 將其描述為超輕量且可自託管。它可以在 WebUI、終端或聊天應用中執行,並將工具、長期記憶、MCP 整合、模型路由、多智能體委派、排程自動化和一個 OpenAI 相容 API 組合在一個小而可讀的核心中。倉庫元資料將 Python 列為主要語言,專案以 MIT 授權散佈。README 中沒有包含效能基準或安全稽核結果;這些事實並未由來源檔案建立。

nanobot README 可核對的背景資料1: English | 简体中文 | 繁體中文 | Español | Français | Bahasa Indonesia | 日本語 | 한국어 | Русский | Tiếng Việt Discord · X · WeChat / Feishu # nanobot nanobot is an ultra-lightweight, open-source, self-hosted personal AI agent framework written in Python. It runs in a WebUI, terminal, or chat apps and combines tools, long-term memory, MCP integrations, model routing, multi-agent delegation, scheduled automation, and an OpenAI-compatible API in a small, readable core. ## Start Here | You want to... | Go to | |---|---| | Install nanobot with。這些內容只描述 nanobot 已公開的介面與用途;README 沒有交代的部署細節、模型效果或權限行為,本文保留為未說明,不把推測寫成保證。

nanobot 核對項目1:依 README 的安裝命令處理依賴,檢查文件指定的設定檔與環境變數,再用文件中的輸入格式執行一次。請記錄終端輸出、產生的檔案、退出狀態與錯誤位置,並分開觀察首次執行和再次執行的差異。若這個專案沒有說明某個平台、資料源或權限情境,該情境就只能列為未驗證範圍,不能從相似工具推導結論。

安裝選項與前提條件

README 記錄了四種安裝方式。macOS 和 Linux 的一鍵安裝腳本使用 curl,Windows PowerShell 對應命令使用 irm。兩者預設從 PyPI 安裝或升級 nanobot-ai 套件,然後在新桌面上啟動 nanobot webui。使用 uv 工具安裝的命令是 uv tool install nanobot-ai,pip 安裝使用 python -m pip install nanobot-ai。原始碼安裝需要 bun 或 npm 以及一個啟用的虛擬環境。要求 Python 3.11 或更新版本。README 提到,在 macOS 或 Linux 上 pip 可能報告 externally-managed-environment,建議使用一鍵安裝器、uv 工具、pipx 或虛擬環境。這些命令均直接引自 README。

nanobot README 可核對的背景資料2: Discord · X · WeChat / Feishu # nanobot nanobot is an ultra-lightweight, open-source, self-hosted personal AI agent framework written in Python. It runs in a WebUI, terminal, or chat apps and combines tools, long-term memory, MCP integrations, model routing, multi-agent delegation, scheduled automation, and an OpenAI-compatible API in a small, readable core. ## Start Here | You want to... | Go to | |---|---| | Install nanobot with no terminal/config background | [Start Without Technical Background](./docs/start-without-technical-background.md) | | Install quickly a。這些內容只描述 nanobot 已公開的介面與用途;README 沒有交代的部署細節、模型效果或權限行為,本文保留為未說明,不把推測寫成保證。

nanobot 核對項目2:依 README 的安裝命令處理依賴,檢查文件指定的設定檔與環境變數,再用文件中的輸入格式執行一次。請記錄終端輸出、產生的檔案、退出狀態與錯誤位置,並分開觀察首次執行和再次執行的差異。若這個專案沒有說明某個平台、資料源或權限情境,該情境就只能列為未驗證範圍,不能從相似工具推導結論。

首次執行與三種介面

建議的首次命令是 nanobot webui,它會在需要時建立設定與工作區,在確認後安全啟用本機 WebSocket 通道,啟動閘道,並開啟 http://127.0.0.1:8765。新安裝可以在設定模型之前開啟,因此設定會繼續在瀏覽器中進行。首次執行的 WebUI 預設綁定到 localhost,不會暴露到區域網路。要在關閉終端後繼續執行,請使用 nanobot webui --background。閘道命令 nanobot gateway 跳過 WebUI 設定,並在目前終端中執行完整的閘道;nanobot agent 則開啟互動式終端聊天。文件中還提供了一次性形式:nanobot agent -m "Hello!"。

nanobot README 可核對的背景資料3:I agent framework written in Python. It runs in a WebUI, terminal, or chat apps and combines tools, long-term memory, MCP integrations, model routing, multi-agent delegation, scheduled automation, and an OpenAI-compatible API in a small, readable core. ## Start Here | You want to... | Go to | |---|---| | Install nanobot with no terminal/config background | [Start Without Technical Background](./docs/start-without-technical-background.md) | | Install quickly and get one CLI reply | [Install](#-install) and [Quick Start](#-quick-start) | | Open the bundled browser UI | [WebUI](#-webui) | | Conne。這些內容只描述 nanobot 已公開的介面與用途;README 沒有交代的部署細節、模型效果或權限行為,本文保留為未說明,不把推測寫成保證。

nanobot 核對項目3:依 README 的安裝命令處理依賴,檢查文件指定的設定檔與環境變數,再用文件中的輸入格式執行一次。請記錄終端輸出、產生的檔案、退出狀態與錯誤位置,並分開觀察首次執行和再次執行的差異。若這個專案沒有說明某個平台、資料源或權限情境,該情境就只能列為未驗證範圍,不能從相似工具推導結論。

架構與智能體迴圈

README 解釋稱,nanobot 透過將一切圍繞一個小型智能體迴圈來保持輕量:訊息從聊天應用進入,LLM 決定何時需要工具,記憶或技能僅作為上下文被引入,而不是成為重量級的編排層。框架包含檔案、shell、網頁搜尋、網頁抓取、MCP、cron、影像生成和子智能體等工具。工作階段歷史和長期記憶透過一個名為 Dream 的功能處理。README 沒有指定記憶的底層儲存機制或 Dream 的實作細節;這些資訊在來源檔案中不存在。

nanobot README 可核對的背景資料4:odel routing, multi-agent delegation, scheduled automation, and an OpenAI-compatible API in a small, readable core. ## Start Here | You want to... | Go to | |---|---| | Install nanobot with no terminal/config background | [Start Without Technical Background](./docs/start-without-technical-background.md) | | Install quickly and get one CLI reply | [Install](#-install) and [Quick Start](#-quick-start) | | Open the bundled browser UI | [WebUI](#-webui) | | Connect Telegram, Discord, WeChat, Slack, Email, Mattermost, or another chat app 。這些內容只描述 nanobot 已公開的介面與用途;README 沒有交代的部署細節、模型效果或權限行為,本文保留為未說明,不把推測寫成保證。

nanobot 核對項目4:依 README 的安裝命令處理依賴,檢查文件指定的設定檔與環境變數,再用文件中的輸入格式執行一次。請記錄終端輸出、產生的檔案、退出狀態與錯誤位置,並分開觀察首次執行和再次執行的差異。若這個專案沒有說明某個平台、資料源或權限情境,該情境就只能列為未驗證範圍,不能從相似工具推導結論。

WebUI 打包與部署

WebUI 隨發布的 wheel 套件一起提供,因此透過 PyPI 安裝時不需要單獨的前端建置。對於雲端部署,倉庫提供了一個 Render Blueprint,要求提供 ANTHROPIC_API_KEY 和私有的 NANOBOT_WEB_TOKEN;持久化儲存需要付費的 Render 服務。自託管路徑在部署指南中有所說明,涵蓋 Docker、Docker Compose、Linux 服務和 macOS LaunchAgent。背景執行也支援使用 nanobot gateway --background。README 沒有指定任何部署模式的資源需求或擴充限制。

nanobot README 可核對的背景資料5:ant to... | Go to | |---|---| | Install nanobot with no terminal/config background | [Start Without Technical Background](./docs/start-without-technical-background.md) | | Install quickly and get one CLI reply | [Install](#-install) and [Quick Start](#-quick-start) | | Open the bundled browser UI | [WebUI](#-webui) | | Connect Telegram, Discord, WeChat, Slack, Email, Mattermost, or another chat app 。這些內容只描述 nanobot 已公開的介面與用途;README 沒有交代的部署細節、模型效果或權限行為,本文保留為未說明,不把推測寫成保證。

nanobot 核對項目5:依 README 的安裝命令處理依賴,檢查文件指定的設定檔與環境變數,再用文件中的輸入格式執行一次。請記錄終端輸出、產生的檔案、退出狀態與錯誤位置,並分開觀察首次執行和再次執行的差異。若這個專案沒有說明某個平台、資料源或權限情境,該情境就只能列為未驗證範圍,不能從相似工具推導結論。

發布、更新與貢獻

README 中提到的最新版本是 v0.3.0,名為「The Agency Release」,增加了內聯子智能體、按工作階段切換模型、引導式 WebUI 設定和即時設定變更。README 中列出的近期更新覆蓋 2026-07-20 至 2026-07-24 的變化,包括引導式首次設定、帶託管 X Search 的 Grok OAuth、平行搜尋和 Codex 快速模式。該專案由社群協作維護,最初由 Xubin Ren 建立。倉庫元資料顯示,在快照時點有 46,645 顆星和 8,252 個復刻。MIT 授權授予使用、複製、修改、合併、發布、分發、再授權和銷售副本的權利,但軟體按「原樣」提供,不附帶任何擔保。

nanobot README 可核對的背景資料6:thout-technical-background.md) | | Install quickly and get one CLI reply | [Install](#-install) and [Quick Start](#-quick-start) | | Open the bundled browser UI | [WebUI](#-webui) | | Connect Telegram, Discord, WeChat, Slack, Email, Mattermost, or another chat app 。這些內容只描述 nanobot 已公開的介面與用途;README 沒有交代的部署細節、模型效果或權限行為,本文保留為未說明,不把推測寫成保證。

nanobot 核對項目6:依 README 的安裝命令處理依賴,檢查文件指定的設定檔與環境變數,再用文件中的輸入格式執行一次。請記錄終端輸出、產生的檔案、退出狀態與錯誤位置,並分開觀察首次執行和再次執行的差異。若這個專案沒有說明某個平台、資料源或權限情境,該情境就只能列為未驗證範圍,不能從相似工具推導結論。

編輯結論

nanobot 被描述為一個小型核心的智能體執行環境,可從 PyPI 或原始碼安裝,在 WebUI、終端或聊天應用中執行,並透過工具、記憶與自動化擴充。README 未提供基準測試、安全稽核或生產支援細節,這些問題仍待驗證。 採用前請先依 nanobot README 的實際命令、設定檔與輸入輸出做一次最小流程,確認你的環境能重現文件描述的結果;若核心整合或安全邊界未被文件說明,就不宜直接放進不可逆的正式流程。

官方來源

  1. Official documentation
  2. Official README
  3. Project repository
  4. Release notes
社群筆記

社群筆記