octos-org/octos

Octos – 自分で実行するオープンソースの「エージェントOS」

何であるか – OctosはRustで書かれたバックエンドで、自分のマシン（またはセルフホスティングサーバー）上でフル機能のAIアシスタントを実行できます。OpenAI、Anthropic、Gemini、DeepSeekなど、主要なLLMプロバイダと連携し、豊富なRESTエンドポイントとJSON-RPC「UIプロトコル」を提供します。クライアントアプリが利用できます。

なぜ重要か – 多くのチャットボットプロジェクトは単一ユーザー・単一モデルのサービスにとどまります。Octosはマルチテナントを前提に設計されています：31MBの単一バイナリで、数百の隔離された「プロファイル」をホスト可能。各プロファイルには独自のプロンプト、モデル、ツール、メモリが設定できます。また、マルチLLMパイプライン（異なるステップで異なるモデル）とスウォームディスパッチもサポートしており、複数のワーカーに作業を分散し、結果を統合できます。

主要コンポーネント

• Kernel（このリポジトリ） – コアランタイム：プロバイダアダプタ、ツールサンドボックス、メモリレイヤー、セッション管理、HTTP/WebSocket API。
• octos-web – ブラウザベースのUI（チャット、音声、ドキュメント作成、管理者ダッシュボード）で、バイナリにバンドルされ、/app/で提供されます。
• octoscode – Claude Codeに似たターミナルスタイルのクライアント。

実行方法

1. Homebrew、npm、または提供された install.sh スクリプトでバイナリをインストール。
2. octos init を実行してプロバイダとモデルを選択し、octos auth login でログイン。
3. octos serve --solo（ローカル開発用）でサーバーを起動、またはバックグラウンドサービスとしてインストール（ポート8080）。
4. http://localhost:50080/app/（またはサービスポート）を開き、チャットを開始。

実際に使える機能

• 80以上のRESTエンドポイント：チャット、セッション、プロファイル、スキル、スケジューリング、メトリクス、Webhookなど。
• 14のメッセージチャネル（Telegram、Discord、WhatsApp、Slack風サービス、Matrixなど）– 同じバックエンドが複数のチャットアプリからアクセス可能。
• ツールサンドボックス – bwrap、Landlock、Docker、Windows AppContainerを使用して、コード実行、ウェブ検索、ファイル操作、オフィススイート生成（DOCX/PPTX/XLSX）を安全に実行。
• 3層メモリ – 長期エンティティストア、エピソード型Redbストア、LLM駆動のコンパクション付きのセッションごとのJSONL。
• 自律性プリミティブ – /goal <目的> で複数ターンにわたって作業を継続、/loop で定期タスク実行、任意の過去のターンにセッションをロールバック可能。
• スウォームディスパッチャー – 複数のワーカー（外部MCPツール含む）にリクエストを分散し、結果を統合。コスト追跡とフェイルオーバー機能を内蔵。
• プロバイダフェイルオーバー – 3層ルーティング（リトライ → チェーン → アダプティブ）で、モデル間のリスク分散とエラー時の回路遮断を実現。
• 他の言語用バインディング – C/Go（octos-ffi）、Python（octos-pyo3）、Swift/Kotlin（octos-uniffi）、WebAssembly（octos-wasm）。
• UIプロトコル v1 – WebSocketまたはstdio上のJSON-RPC。任意のフロントエンド（Web、ターミナル、エディタ）が同じバックエンドと通信可能。

一般的な利用例

• ローカルにデータを保持しながら、コード実行、ウェブブラウジング、メモの作成が可能な個人用AIアシスタント。
• チーム全体で利用する「エージェントOS」で、各ユーザーに独自のプロファイルを提供しながら、同じサーバーを共有。
• Rustクレートまたは言語バインディング経由で、他のソフトウェアにエージェントループを埋め込む。
• MCP（Model Client Protocol）システムを介して外部ツールを呼び出すカスタムエージェントの構築。

さらに学ぶには

• 完全なドキュメントサイト： https://octos-org.github.io/octos/
• セルフホスティングガイド（クラウド＋テナントデプロイ含む）： https://github.com/octos-org/octos-web#self-hosting--deployment
• ヘルプ用イシュートラッカー： https://github.com/octos-org/octos/issues

---

結論 – Octosは、マルチテナント隔離、拡張可能なツール、多数のLLMプロバイダとの深いつながりを重視した、本格的で生産環境対応のオープンソースプラットフォームです。ドキュメントが充実し、積極的にメンテナンスされており、AI駆動アプリケーションの「オペレーティングシステム」として設計されています。