クラッシュ後の再開や安全なリトライ、各ステップの説明に対応する、合成可能なデータフローとして堅牢なAIエージェントを構築するPythonフレームワーク。
Kocoro-lab/Shannon
Temporalワークフローとトークン予算を備え、本番環境でLLMエージェントを実行するためのGo、Rust、Python製マルチエージェント・オーケストレーションフレームワーク。
- スター
- 2,320
- フォーク
- 361
- 未解決の Issue
- 8
- 最終コミット
- 2 か月前
これは何?
Shannonは、AIエージェントを本番環境で安定して実行するためのマルチエージェント・オーケストレーションフレームワークです。タスクはREST API、OpenAI互換エンドポイント、Python SDK、またはデスクトップアプリから送信でき、複雑さに応じて、単一エージェントによるシンプルな応答、DAGのfan-out/fan-in、ReActループ、リサーチ、tree-of-thoughtsによる探索、スウォームチームなどの実行方式に振り分けられます。
システムは耐障害性を高めるためにTemporal上でワークフローを実行し、デバッグ用に過去の実行をリプレイできます。タスクごとにトークン予算を設定でき、上限に近づくと自動的に低コストのモデルへ切り替わります。コード実行はWASIサンドボックス内で行われ、オプションの人間による承認ゲートを使うと、判断が送信されるまでワークフローを一時停止できます。メトリクスとトレーシングにはPrometheusとOpenTelemetryを使用します。
ShannonはAnthropic、OpenAI、Google、DeepSeek、xAI、Groqに加え、Ollama、LM Studio、vLLM経由のローカルモデルに対応しています。Docker Composeでデプロイでき、定期実行タスク、セッションの継続性、YAMLとMarkdownで定義できるスキルも備えています。
主な機能
- 01タスクの複雑さに応じて実行方式を自動選択
- 02過去の実行をリプレイしてデバッグできるTemporalワークフロー
- 03タスクごとのトークン予算とモデルの自動切り替え
- 04コード実行用のWASIサンドボックスとオプションの人間による承認ゲート
- 05OpenAI互換APIエンドポイント、Python SDK、デスクトップアプリ
- 06OllamaやvLLM経由のローカルモデルを含む、多数のLLMプロバイダーに対応
ユースケース
- コスト上限を設けて複数ステップのリサーチや分析タスクを実行する
- エージェントが慎重な操作を行う前に承認チェックポイントを設ける
- 既存のOpenAI SDKコードから、セルフホスト型のエージェントバックエンドを利用する
- 毎日の市場分析など、エージェントタスクを定期実行する
クイックスタート
- 1
README のワンコマンドインストールスクリプトを実行する(bash にパイプするため、先に内容を確認してください)
- 2
Python SDK をインストールする
pip install shannon-sdk - 3
REST API 経由で最初のタスクを送信する
curl -X POST http://localhost:8080/api/v1/tasks -H "Content-Type: application/json" -d '{"query": "What is the capital of France?", "session_id": "demo"}'
使う前に知っておきたいこと
- Docker と Docker Compose に加え、少なくとも1つの LLM プロバイダーの API キーが必要です。
- ワンコマンドインストールでは、リモートスクリプトを bash にパイプして実行します。
- オプションの Playwright ブラウザーサービスを追加すると、約3.4GBのイメージが追加されます。
収録されている特集
トピック
よくある質問
- Shannon とは?
- Temporalワークフローとトークン予算を備え、本番環境でLLMエージェントを実行するためのGo、Rust、Python製マルチエージェント・オーケストレーションフレームワーク。 Shannonは、AIエージェントを本番環境で安定して実行するためのマルチエージェント・オーケストレーションフレームワークです。タスクはREST API、OpenAI互換エンドポイント、Python SDK、またはデスクトップアプリから送信でき、複雑さに応じて、単一エージェントによるシンプルな応答、DAGのfan-out/fan-in、ReActループ、リサーチ、tree-of-thoughtsによる探索、スウォームチームなどの実行方式に振り分けられます。
- Shannon は無料で使えますか?ライセンスは?
- Shannon は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- Shannon は今もメンテナンスされていますか?
- 半年以内に更新あり。Shannon の最終コミットは 2026年9月5日 です。
- Shannon は何に使えますか?
- コスト上限を設けて複数ステップのリサーチや分析タスクを実行する エージェントが慎重な操作を行う前に承認チェックポイントを設ける 既存のOpenAI SDKコードから、セルフホスト型のエージェントバックエンドを利用する 毎日の市場分析など、エージェントタスクを定期実行する
- Shannon のインストール方法は?
- README のワンコマンドインストールスクリプトを実行する(bash にパイプするため、先に内容を確認してください) Python SDK をインストールする: pip install shannon-sdk REST API 経由で最初のタスクを送信する: curl -X POST http://localhost:8080/api/v1/tasks -H "Content-Type: application/json" -d '{"query": "What is the capital of France?", "session_id": "demo"}'
- Shannon はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/Kocoro-lab/Shannon
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
Claude Code、Codex、Gemini CLIなど既存のAI CLIツールを、並列実行とオーケストレーションに対応した共通のマルチエージェントワークスペースにまとめるデスクトップアプリです。
MicrosoftのUFO³はDAGベースのタスク分解を使って複数デバイス上のGUIエージェントを連携させ、UFO²はWindowsデスクトップエージェントとして機能します。
永続化、メモリ、Human-in-the-loopに対応した、状態を持つ長時間稼働のLLMエージェントをグラフとして構築するTypeScriptフレームワーク。
Spring AIを基盤に、エージェント型AI、ワークフロー、マルチエージェントアプリケーションを構築するJavaフレームワーク。
Context Engineeringに基づくマルチエージェントシステム。エージェントのワークフローを設計、テスト、デプロイできるビジュアルエディターを備えています。