maestro/README.md

MAESTRO

MAESTRO — タスクを LLM 駆動で実行するエージェントオーケストレーションプラットフォーム。タスクの種類を LLM が自動判定し、適切なワークフロー（Piece）で処理する。ツールはサンドボックス化されたランタイムで実行され、ワークスペース・ファイル・進捗を Web UI で管理できる。

OpenAI 互換の LLM エンドポイント（Ollama / vLLM など）があれば単体で動作する。

主な機能

• タスク自動ルーティング — タスク本文を LLM が分類し、最適な Piece（YAML ワークフロー）へ振り分け。
• Piece × Movement — ReAct ループで LLM とツールが対話しながら、段階的にタスクを進める。
• 豊富なツール群 — ファイル操作（Read/Write/Edit/Bash/Glob/Grep）、Office（PDF/Excel/Docx/PPTX）、Web 取得、ブラウザ操作（Playwright）、画像、SQLite、ナレッジ検索（RAG）、SSH、サブタスク並列実行、MCP 連携、ほか。
• Bash サンドボックス — bwrap によるファイルシステム/ネットワーク/環境変数の隔離（不在時は強化版 whitelist にフォールバック）。Python パッケージはプリベイク。
• LLM Gateway（任意） — 仮想キー・予算・メトリクス付きの LLM プロキシ。複数 GPU/チームでの共有運用に対応。
• 学習（Reflection）・定期タスク・タスク共有・OAuth 認証（Google/Gitea） — いずれも任意で有効化。
• Web UI — タスク作成・進捗・成果物プレビュー・設定編集・スキル/Piece 管理。

クイックスタート

Docker（最短）

cp .env.example .env          # OLLAMA_BASE_URL などを設定
docker compose up -d
# http://localhost:9876 を開く

LLM エンドポイントは .env / config.yaml で指定する（既定は http://localhost:11434/v1）。

ソースから

git clone https://gitea.example.com/your-org/maestro.git
cd maestro
npm ci && npm --prefix ui ci
cp config.yaml.example config.yaml      # provider / workers を編集
scripts/build-all.sh
scripts/server.sh start                 # http://localhost:9876

詳しい手順は docs/getting-started.md を参照。

必要要件

• Node.js 22+
• OpenAI 互換の LLM エンドポイント（Ollama / vLLM など）
• 任意（Bash サンドボックス用）: bwrap（bubblewrap, 非特権 user namespace）+ python3/pip

ドキュメント

• docs/getting-started.md — インストール・初回起動・最初のタスク・認証/サンドボックスの有効化
• docs/configuration.md — config.yaml の全設定項目リファレンス
• docs/architecture.md — 実行フロー・Piece/Movement・ツール・DB・サンドボックス
• docs/tools/ — 各ツールの詳細
• docs/operations/bash-sandbox-provisioning.md — 本番でのサンドボックス有効化手順
• AGENTS.md / CONTRIBUTING.md — コントリビュータ向け

サーバー管理

scripts/server.sh start | stop | restart | status | logs

ライセンス

Apache-2.0。