nanobotを読む：小さなコアで組み立てるセルフホスト型AIエージェント

nanobotが一つにまとめる操作面

nanobotはPythonで書かれたオープンソースのセルフホスト型パーソナルAIエージェントフレームワークです。READMEは、WebUI、ターミナル、チャットアプリを入口にして、ツール、長期メモリ、MCP連携、モデルルーティング、マルチエージェント委任、スケジュール実行、OpenAI互換APIを小さなコアへ組み合わせる構成として説明しています。単独のチャット画面ではなく、自分で動かすエージェントゲートウェイとして考える方が実態に近いです。

利用者が触れる入口は三つに分かれます。ブラウザではWebUIを開き、ターミナルではagentやgatewayを実行し、Telegram、Discord、Slack、WeChat、Email、Mattermostなどのチャットアプリへ接続できます。さらにPython SDKとOpenAI互換APIも提供されます。どの入口でも同じ認証、モデル、ツールの境界を共有するのか、入口ごとに設定が分かれるのかは、採用する連携の個別文書で確認すべき点です。

インストールは安定版とソース版を分ける

READMEが示す導入経路は、インストーラー、uv、pip、ソースからの導入です。macOSとLinuxではスクリプト、WindowsではPowerShellのスクリプトが案内され、既定ではPyPIのnanobot-aiをインストールまたは更新します。新しいローカルデスクトップではnanobot webuiを起動し、SettingsのModels画面で最初のプロバイダーとモデルを設定する流れです。ターミナルを使わない人向けの導入文書も用意されています。

安定した日常利用を優先する場合はPyPIまたはuv、最新機能や実験的変更を追う場合はソース版、という選択がREADMEの整理です。前提はPython 3.11以上で、ソース導入だけGitとBunが必要です。公開パッケージにはWebUIが含まれ、初回利用時にバージョン対応したTUIアーカイブを取得します。pipでexternally-managed-environmentが出る環境では、uv、pipx、仮想環境、またはインストーラーを使うよう案内されています。導入スクリプトを実行する前に、dry-runで変更予定を確認できる点も実運用では役立ちます。

初回実行で選ぶWebUI、gateway、agent

初めて起動する人にはnanobot webuiが中心となります。設定とワークスペースの作成を進め、ローカルのWebUIからプロバイダーとモデルを登録してゲートウェイを開始します。初回のWebUIはlocalhostへバインドされ、README上はLANへ公開されません。ターミナルを閉じても動かしたい場合はnanobot webui --backgroundが用意されています。SSHやヘッドレス環境、既存設定、古いリリースでは、端末のセットアップウィザードを使う経路が維持されます。

nanobot gatewayはWebUIのセットアップを省き、現在のターミナルで完全なゲートウェイを動かすコマンドです。nanobot agentは対話型のターミナルチャットを開き、agent -mで一回だけメッセージを送る使い方も文書化されています。ブラウザを使う人、サーバー上で常駐させる人、手動で対話する人が同じコマンドを使うわけではありません。導入後の障害切り分けのためにも、どのプロセスが設定を読み、どのプロセスが外部チャネルを受け持つかを把握しておく必要があります。

エージェントループとツールの境界

READMEの説明では、nanobotは小さなエージェントループを中心に構成されています。メッセージを受け取ると、LLMがツールを呼ぶ必要性を判断し、ファイル、シェル、Web検索、Web取得、MCP、cron、画像生成、サブエージェントなどを使います。メモリやスキルは必要なコンテキストとして読み込まれ、巨大なオーケストレーション層として常に常駐する設計ではない、と説明されています。

セッション履歴と長期メモリはDreamという機能で扱われ、長時間の目標やスケジュール自動化にも対応します。ここで注意したいのは、ツール名が並んでいることと、各ツールを安全に運用できることは別だという点です。シェルやファイル操作を有効にするなら実行ユーザー、ワークスペース、秘密情報の置き場所を確認し、外部検索やチャット連携では送信データの範囲を定める必要があります。READMEはメモリの内部ストレージ方式やDreamの詳細なデータ保持契約までは説明していません。

プロバイダー設定とモデル切り替えを管理する

nanobotはOpenAI互換API、ローカルLLM、画像生成、検索、フォールバックモデルを組み合わせられる構成です。WebUIの設定画面では初回プロバイダーとモデルを登録し、v0.3.0の説明にはセッションごとのモデル切り替えとライブ設定変更が追加されたとあります。複数のモデルを使い分ける場合、価格、レート制限、コンテキスト長、ツール呼び出しの対応はプロバイダーごとに異なります。プロジェクトの説明だけで同じ挙動を期待することはできません。

モデルルーティングやフォールバックは便利ですが、切り替わった先のモデルへ同じデータと権限が渡る可能性があります。運用では、通常モデルが失敗したときにどのモデルへ移るか、画像生成やWeb検索の認証がどこに保存されるか、外部APIの失敗をユーザーへどう表示するかを決めてください。nanobotが構成を変更できるという事実はREADMEから確認できますが、組織のポリシーに沿う既定値や、各サービスの料金を保証する情報は文書にありません。

WebUIと常駐配置の選択肢

WebUIは公開wheelに含まれるため、PyPIから導入した場合に別途フロントエンドをビルドする必要はありません。セルフホスト向けのデプロイ文書はDocker、Docker Compose、Linuxサービス、macOS LaunchAgentを扱い、バックグラウンド実行にはgateway --backgroundもあります。クラウド配置ではRender Blueprintが用意され、ANTHROPIC_API_KEYと非公開のNANOBOT_WEB_TOKENを要求します。永続ストレージには有料のRenderサービスが必要だと注記されています。

この構成は、小さな端末で個人用に使う場合と、サーバー上で長時間動かす場合を同じプロジェクトで扱える点が強みです。一方、READMEは各配置方式のCPU、メモリ、同時接続数、ログ保持量、スケール上限を示していません。チャットアプリを複数接続する場合は、長期メモリやセッション履歴の保存先とバックアップ方針を先に決めるべきです。常駐プロセスを公開ネットワークへ置く前に、トークン、プロバイダーキー、MCPサーバー、シェルツールの権限を別々に点検してください。

リリース情報から読む現在地と未検証領域

素材取得時点の最新リリースとしてv0.3.0が記録され、v0.2.2とv0.2.1も公開されています。READMEはv0.3.0をThe Agency Releaseと呼び、インラインサブエージェント、セッション単位のモデル変更、ガイド付きWebUIセットアップ、ライブ設定変更を挙げています。リポジトリの説明には、2026年7月20日から24日までの更新として初回セットアップ、Grok OAuthを使うホスト型X Search、並列検索、Codex高速モードなども記載されています。これらはリリースとREADMEが示す機能情報であり、特定の環境での性能評価ではありません。

nanobotはMITライセンスで公開されています。コピー、変更、統合、公開、配布などを許可する一方、ソフトウェアは現状のまま提供され、保証や本番サポートを意味しません。READMEには性能ベンチマーク、セキュリティ監査、本番時の対応時間、運用規模の上限は示されていません。導入判断では、まずローカルでモデル、チャネル、ツール、メモリを最小構成にし、次に常駐配置と外部公開を段階的に追加してください。

編集部の結論

nanobotは、Python 3.11以上の環境で自分のプロバイダー設定とワークスペースを管理しながら、ブラウザ、ターミナル、チャットアプリから同じエージェントを使いたい人に向きます。導入前にはモデル料金、外部サービスへ送るデータ、トークン管理、バックグラウンド実行、永続ストレージの条件を確認してください。READMEだけでは性能ベンチマーク、監査結果、規模上限までは判断できません。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes