HKUDS/nanobot：README に基づく導入ガイド

HKUDS/nanobot の README はプロジェクトを「Ultra-lightweight, open-source, self-hosted personal AI agent framework in Python with WebUI, tools, memory, MCP, multi-agent workflows, automation, and chat apps」と説明しています。ここではリポジトリで確認できる事実だけを整理します。star 数やバッジは注目度の手掛かりであり、品質の証明ではありません。「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。これは範囲の説明であり、本番検証の結果ではありません。

README の「What can nanobot do?」にある内容から、用途が合うかを先に判断できます。use tools such as files, shell, web search, web fetch, MCP, cron, image generation, and subagents。目的が違うなら、人気だけで採用する理由にはなりません。プロジェクト名やコマンドは原文のまま残し、一次資料へ戻って用語を確認できるようにしています。 README には次の確認可能な項目もあります。connect to Telegram, Discord, Slack, WeChat, Email, Mattermost, and other chat apps。初回テストの材料にはなりますが、実際の環境での確認を省略する理由にはなりません。

動作の説明は「What can nanobot do?」など複数の箇所に分かれています。確認できる情報は次の通りです。nanobot is a self-hosted personal AI agent runtime. It can:。書かれていない構成、性能、セキュリティを推測で補いません。導入時はディレクトリ、設定ファイル、release 履歴を確認してください。

初回導入は README の入口から始めます。確認できるコマンドは次の通りです。 curl -fsSL https://raw.githubusercontent.com/HKUDS/nanobot/main/scripts/install.sh | sh 実行可能なコマンドがない場合は手順を作らず、「Start Here」で依存関係、待受ポート、初回設定を確認します。

日常運用は公式文書の範囲に限ります。「📦 Install」には> [!IMPORTANT] > If you want the newest features and experiments, install from source. > > If you want the most stable day-to-day experience, install from PyPI or with uv.とあります。設定、環境変数、権限、データ保存先は明記されたものだけを扱います。未記載の既定値は隔離環境で確認し、戻せる設定を保存してください。 同じ資料にはkeep session history and long-term memory through Dreamともあります。