ReadyAgents

ReadyAgents Core

ReadyAgents は YAML エージェントワークフローをローカルで実行します。すべてのノードでチェックポイントが作成されるため、実行を一時停止して人間の承認を待ち、中断したところから再開し、オフラインで回帰テストとして再生できます。キーはあなたのもの、実行環境はあなたのマシン。デーモンは不要です。

サイト：readyagents.dev。リポジトリ：github.com/readyagentsdev/readyagents-core。

試してみましたか？試してみたのイシューを作成してください。ローンチを控えているわけではありません。皆さんの声を聞いています。

このリポジトリは無料のコアです。プロバイダーアカウントと料金はご自身で管理します。pip install readyagentsdevでインストールするか、このクローンからインストールしてください。

60秒で始める

Linux、macOS、WindowsでPython 3.11–3.14が必要です。現在のバージョンは2.0.12です。pip install readyagentsdevでインストールするか、このクローンからインストールしてください。2はコアの契約のバージョンのみを示します。追加機能にはそれぞれ独自の成熟度レベルがあります。

pip install readyagentsdev
readyagents new my-flow
readyagents run my-flow/workflow.yaml
readyagents runs list

wheelにはサンプルワークフローも含まれているため、クローンは不要です。

readyagents new f --from-example calc_pipeline
readyagents run f/workflow.yaml

readyagents new --list-examplesですべてのサンプルを確認できます。

または、クローンから実行します。

git clone https://github.com/readyagentsdev/readyagents-core.git
cd readyagents-core
python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .
readyagents run examples/calc_pipeline.yaml
readyagents runs list
readyagents doctor

readyagents run examples/calc_pipeline.jsonは同じグラフを実行します。

次はHITLです：docs/first-ten-minutes.md。

できること

• エージェントワークフローをYAMLまたはJSON（ノード＋エッジ）で定義します
• エージェント、ツール、条件、変換、承認、並列、インクルード、foreach、decideノードを実行します。エージェントノードでは、上限を設けたツール使用ループ用にtools:許可リストを宣言できます。type: decideは実験的機能です。docs/decisions.mdを参照してください。
• 各ノードの実行後に状態を永続化し、一時停止または失敗した実行を、最後に成功したノードから再開します
• 過去の実行を確認します：readyagents runs list / show / replay / fork / diff / freeze / report（ローカルHTML）
• スターターを作成します：readyagents new my-flow（basic、approval、research、pipeline、review、foreach、agent-tools、gated、decide）
• 追加サーバー不要の組み込みツール：now、calc、json_get、list_dir、read_file、write_file
• MCP クライアントとサーバー（readyagents mcp serve、readyagents mcp probe）。公式タスクとMRTR承認に対応しています
• ポリシー、支出台帳、予算、上限：ノードごとのトークン数／コスト、--estimate / --max-spendによる上限設定、モデルのフォールバック、JSONログ

コアに加え、40以上のオプトイン機能が同じインストールに含まれます。チーム、スタジオ、ブラウザー、ナレッジ、蒸留、レジストリ、環境などが用意されています。それぞれの成熟度レベルと制限はdocs/extras.mdに記載されています。いずれも必須ではなく、コアの動作に影響を与えることもありません。

エージェントファイアウォール（汚染追跡、ツールポリシー、MCPのピン留め。セキュリティモデル、ポリシー）は多層防御であり、プロンプトインジェクションを解決するものではありません。

アーキテクチャ

flowchart LR
  YAML[Workflow YAML/JSON] --> Engine
  subgraph Core["ReadyAgents Core"]
    Engine[Workflow engine]
    Tools[Builtin tools]
    LLM[BYOK LLM providers]
    MCP[MCP client / server]
    Packs[Pack loader]
  end
  Engine --> Tools
  Engine --> LLM
  Engine --> MCP
  Packs --> Engine
  Packs --> Tools
  LLM --> OpenAI[OpenAI]
  LLM --> Anthropic[Anthropic]
  LLM --> Compat[OpenAI-compatible]

CLI

コマンド	目的
readyagents init	.env が存在しない場合、.env.example から作成します
readyagents new [name] [--template basic|approval|research|pipeline|review|foreach|agent-tools|gated|decide] [--from-example NAME] [--list-examples]	ワークフロー、README、.env.example、ローカル JSON Schema を生成するか、同梱のサンプルをコピーします
readyagents import SOURCE PATH [--out DIR] [--explain SOURCE]	n8n／LangGraph／CrewAI／トリガーアクションのエクスポートをインポートします（構造のみを変換）
readyagents validate PATH	ワークフローをスキーマ検証します（失敗時はエラーの発生元を表示）
readyagents schema	生成されたワークフロー JSON Schema を表示／書き込み／チェックします
readyagents eval PATH	キー不要のフィクスチャスイートを評価します（終了コード 0／1）
readyagents simulate PATH [...]	宣言に基づくケースを eval で評価します。個別の失敗は固定されます
readyagents optimize PATH --eval SUITE	eval スイートを基に、プロンプトを振り返りながら最適化します
readyagents prompts list / show / history / diff / rollback	ワークフローと並べてプロンプトをバージョン管理します。ロールバックで正確に復元します
readyagents env status / history / diff / deploy	宣言された環境と固定されたリリースを管理します
readyagents registry scan / annotate / check / list / show / stats / card / export	宣言されたルートからローカルのエージェント一覧を作成します（Annex VIII のエクスポートはドラフトです）
readyagents distill plan / dataset / train / evaluate / promote	同意を得た実行履歴からローカルの単一ノードアダプターを作成します（pack のトレーニングには holdout が必要です）
readyagents promote PATH --from SRC --to DST	eval／フィクスチャ／ベンチマーク／ヘルス／承認ゲートを通過した後、ソースのピン留めをターゲットにコピーします
readyagents rollback --env NAME	以前のリリースをアトミックに復元します。自動で先に進むことはありません
readyagents feedback export / stats	同意に基づく修正データセット（本番データ）
readyagents run PATH [--input KEY=VALUE] [--dry-run] [--approve NODE] [--reject NODE] [--decision-file FILE] [--actor NAME] [--pack PATH] [--policy PATH] [--estimate] [--max-spend USD] [--max-tokens N] [--label KEY=VALUE] [--sovereign] [--stream] [--env NAME]	実行します（--estimate を指定すると、実行せずに見積もります）。--env はピン留めされたリリースを実行します。--stream は明示的な指定が必要です
readyagents batch PATH --input-file FILE [--concurrency N] [--max-spend USD] [--out FILE]	フォアグラウンドで、1 つのワークフローに複数の JSONL／CSV 行を処理させます（明示的な指定が必要です）
readyagents attest RUN_ID	データ保存場所の証明（技術的な証拠であり、法令遵守の証明ではありません）
readyagents bundle --out DIR	pip install --no-index --find-links 用のオフライン wheel セット
readyagents resume RUN_ID [--approve NODE] [--reject NODE] [--decision-file FILE] [--policy PATH]	一時停止または失敗した実行を再開します
readyagents wake	待機条件を評価します（遅延実行。タイマーやデーモンは起動しません）
readyagents event	署名付きイベントを注入します（署名のないイベントは拒否されます）
readyagents policy check PATH	ファイアウォールポリシーファイルを検証します（フェイルクローズ）
readyagents policy explain PATH [--policy PATH]	各ノードが呼び出せるツールとその理由を表示します
readyagents evidence RUN_ID [--out DIR]	ローカルの証拠パック
readyagents audit verify [--file PATH]	ハッシュチェーン形式の監査履歴をたどります
readyagents spend [--since DATE] [--by day|workflow|model|actor|label]	TokenOps：ローカルの支出台帳を集計します（プロバイダーの請求書と照合するための参考情報です）
readyagents graph PATH	決定論的な Mermaid ルーティングを表示します（実行はしません）
readyagents decide RUN_ID [--file FILE | --node ID --decision approve] [--token-file JWT] [--actor NAME] [--reason TEXT]	承認を注入します。--actor はデフォルトのままで、--token-file が識別情報を示します
readyagents approvals list [--role ROLE] [--actor NAME] [--expiring-within 1h]	呼び出し元が確認できる、一時停止中のゲートのキュー
readyagents delegate --from A --to B --until TS [--scope ROLE]	期限付き、単一ホップで取り消し可能な承認委任
readyagents delegations list | revoke ID	ローカルの委任を一覧表示または取り消します
readyagents identity verify --token-file JWT	ローカルの信頼アンカーに照らしてアサーションを検証します
readyagents identity whoami	ワークロードのフィンガープリント（秘密鍵は決して表示しません）
readyagents runs list	永続化された実行を一覧表示します
readyagents runs show RUN_ID	ノードのタイムラインと保存された状態を表示します（inspect はエイリアスです）
readyagents runs report RUN_ID	実行のローカル HTML サマリー
readyagents runs replay RUN_ID	保存された入力から新たに実行します
readyagents runs delete RUN_ID --yes	ローカルの実行記録を 1 件削除します
readyagents runs gc --yes	成功／失敗／キャンセル済みの実行を整理します（一時停止中の実行は保持されます。保持期間内の記録は --override-retention がない限り削除できません）
readyagents runs fork / diff / freeze / migrate	タイムマシン：実行を分岐し、2 件を比較し、カセットを固定し、JSON から SQLite に移行します
readyagents connectors list / show / test	小規模なガバナンス付きカタログ（rest、sql、object_storage、message、ingest）— SaaS を 500 件集めたものではありません
readyagents sign / verify / lock / sbom / trust	サプライチェーン：署名が証明するのは出所であり、安全性ではありません
readyagents approvals serve	フォアグラウンドでローカルホストの承認ページを起動します
readyagents studio [--port 8790] [--open] [--read-only]	フォアグラウンドでローカルホストのキャンバスと実行インスペクターを起動します
readyagents models list / show / route --explain	モデルカタログとルーティングの説明をドライ実行します（プロバイダーへの呼び出しはありません）
readyagents mcp serve	stdio MCP サーバー（組み込みツール）。--json はプロトコルのバージョンを出力します
readyagents mcp probe URL	読み取り専用の server/discover 診断です（ツールは呼び出しません）
readyagents a2a serve PATH	1 つのワークフロー用 A2A ドアをフォアグラウンドで起動します（デフォルトではループバック）
readyagents a2a card PATH	決定論的な Agent Card を生成します（ネットワークは使用しません）
readyagents a2a probe URL	リモートカードの読み取り専用診断です（シークレット値は表示しません）
readyagents memory list / show / search / forget / export	スコープ付きのローカルメモリ（任意の埋め込みを除き、オフラインで動作します）
readyagents knowledge ...	ナレッジドキュメントを取り込み、同期し、引用し、忘却します（フォアグラウンドのみ）
readyagents table ...	中間テーブルの head、スキーマ、統計を確認します
readyagents triggers ...	宣言されたトリガーの確認、マッピングのドライ実行、イベントの一覧表示を行います（リスナーは起動しません）
readyagents skills ...	Agent Skills をインストール、一覧表示、エクスポート、削除します（オープンフォーマット。マーケットプレイスはありません）
readyagents agents-md	このプロジェクトでワークフローを実行、検証、テストする方法を含むコンテキストを出力します
readyagents package ...	ワークフローパッケージをビルド、インストール、カタログ化します（インストール前にレビューします）
readyagents health	実行ストア内の障害をフィンガープリント別に分類します（デーモンやテレメトリーはありません）
readyagents bench ...	デフォルトでオフラインのベンチマークスイートです。エンジンの計測値と実環境の計測値をラベル付きで表示します
readyagents sessions ...	会話セッションの一覧表示、確認、終了、再生、固定を行います（各ターンは実行として扱われます）
readyagents serve ...	フォアグラウンドでループバックの各種エンドポイントを起動します（プロセスの終了時に停止します）
readyagents packs [--pack PATH]	インストール済み／ローカルの pack を一覧表示します
readyagents doctor	プラットフォーム／追加コンポーネント／権限／ループバック／実行ストア／ソブリン構成を読み取り専用で診断します
readyagents version	バージョンを出力します

例（特に記載がない限りキー不要）

ファイル	内容
examples/calc_pipeline.yaml	組み込みツール、変換、条件
examples/calc_pipeline.json	calc_pipeline.yaml と同じグラフ
examples/approval_gate.yaml	ヒューマン・イン・ザ・ループによる一時停止／再開
examples/ollama_local.yaml	キー不要のループバック OpenAI 互換パス（実際のモデルは不要）
examples/quorum_gate.yaml	2 人の承認者によるゲート（キー不要）
examples/expiring_gate.yaml	遅延期限、on_expire: reject（キー不要）
examples/multi_gate.yaml	2 つの承認ゲートを順次実行
examples/fanout_gate.yaml	並列ブランチ＋承認
examples/include_demo.yaml	サブワークフローの include（new --from-example）
examples/composed_gate.yaml	Include＋並列処理＋承認（new --from-example）
examples/research_brief.yaml	エージェントノード（キーが必要）
examples/support_triage.yaml	分類してから分岐（キーが必要）
examples/code_review.yaml	read_file＋レビュー（キーが必要）
examples/agent_tools.yaml	エージェントの tools: [calc]（キーが必要。--dry-run はキー不要）
examples/foreach_calc.yaml	順次 foreach＋calc（キー不要）
examples/policy_gated.yaml	汚染された write_file に対するポリシーゲート（キー不要）
examples/readyagents.policy.yaml	ファイアウォールポリシーのスターター設定
examples/json_mutate.yaml	json_set／json_merge（キー不要）
examples/table_pipeline.yaml	type: table＋type: classify（キー不要で検証可能）
examples/list_dir.yaml	組み込みの list_dir（キー不要、MCP 不要、Node 不要）
examples/eval/pass.yaml	キー不要の readyagents eval フィクスチャスイート
examples/a2a_delegate.yaml	type: a2a のドライラン（ネットワーク不要）
examples/memory_triage.yaml	type: memory で書き込み後に検索（キー不要）
examples/code_reshape.yaml	type: code による JSON の入出力（キー不要、サブプロセス）
examples/batch_echo.yaml	キー不要の readyagents batch による行のエコー（batch_rows.jsonl／.csv）
examples/connector_rest.yaml	ローカルのフィクスチャに対するキー不要の rest コネクター
examples/connector_demo.yaml	ローカルの --pack コネクター（examples/packs/connector_pack.py）
examples/gated_write.yaml	承認後に write_file を実行（キー不要）
examples/env/echo.yaml	キー不要の環境デプロイ＋run --env（examples/env/readyagents.env.yaml）

ドキュメント

• ReadyAgents を選ぶ理由
• はじめに
• 最初の 10 分
• 概念
• 設定（BYOK）
• ワークフロー
• 作成（JSON Schema、エディター、位置情報付きエラー）
• コネクター（小規模なカタログ。書き込み操作はデフォルトでゲートされます）
• ソブリンモード（プロセス内の外部送信を拒否しますが、OS サンドボックスではありません）
• コスト / TokenOps（プロバイダーの請求額とは異なる参考情報です）
• タイムマシン（記録 / 再生 / 分岐 / 差分 / 凍結）
• MCP · MCP 貼り付けカタログ
• A2A（信頼できないリモートコンテンツ。委任による情報流出の可能性があり、認証ではありません）
• メモリ（信頼できない情報。遅延インジェクションやスコープ逸脱の可能性があります）
• スケーリングとバッチ（オプトインのフォアグラウンドバッチ。ベンチマークはエンジンとライブを区別して表示します）
• ストリーミング（オプトインの --stream。音声には対応していません）
• ガードレール / 出力コントラクト（オプトインの contract:。宣言されたルール）
• マルチエージェントチーム（オプトインの type: team。メンバーは限定され、品質を保証するものではありません）
• モデルルーティング（オプトインの routing:。宣言されたポリシー）
• マルチモーダル I/O（オプトインの MediaPart / type: document / type: transcribe。追加機能。OCR を保証するものではありません）
• ナレッジパイプライン（オプトインの type: ingest。引用 / 鮮度）
• データパイプライン（オプトインの type: table / type: classify）
• 長時間待機（オプトインの type: wait。遅延実行の wake）
• イベントトリガー（オプトインの triggers:。コアにはリスナーがなく、少なくとも 1 回の実行と冪等性が必要です）
• エージェントスキル（オプトインの type: skill。オープンフォーマット）
• ガバナンスされたブラウザー利用（オプトインの type: browser。宣言されたアクション。CAPTCHA には対応していません。オプションのパック）
• 会話型セッション（オプトインの type: converse。ループバックの serve chat。コアでは音声に対応していません）
• 環境とロールアウト（オプトインの readyagents.env.yaml。リリースを固定し、ゲート付きで昇格）
• 移行（オプトインの readyagents import。構造のみを変換します）
• エージェントレジストリ（オプトインの readyagents registry。宣言されたルート。Annex VIII のドラフトエクスポート）
• 蒸留（オプトインの readyagents distill。パック所有のトレーニング。ホールドアウトでゲートされたアダプター）
• パッケージング（オプトインの readyagents package。インストール前にレビュー）
• シミュレーション（オプトインの readyagents simulate。宣言駆動型のケース）
• 自己修復（オプトインの readyagents health / recovery:。フィンガープリントとフェイルセーフゲート）
• ベンチマーク（オプトインの readyagents bench。オフラインのカセット）
• パック
• サプライチェーンの信頼性（署名で証明できるのは出所であり、安全性ではありません）
• 継続的パック（オプション。個別に配布）
• プラットフォームサポート
• CLI
• コンプライアンス証拠（第 12～14 条への対応付け。認証ではありません）
• オブザーバビリティ
• 変更履歴
• リリースノート 2.0.12

追加機能のインストール

LLM と MCP の追加機能はオプションです。

pip install "readyagentsdev[openai]"
pip install "readyagentsdev[anthropic]"
pip install "readyagentsdev[gemini]"
pip install "readyagentsdev[bedrock]"
pip install "readyagentsdev[vertex]"
pip install "readyagentsdev[mcp]"
pip install "readyagentsdev[all]"
pip install "readyagentsdev[image]"
pip install "readyagentsdev[pdf]"
pip install "readyagentsdev[audio]"
pip install "readyagentsdev[table]"

クローンしたリポジトリでは、同じ追加機能を pip install -e ".[openai]"（および anthropic / gemini / bedrock / vertex / mcp / all）でインストールできます。オプションの [otel] 追加機能は [all] に含まれません。コレクターは起動しません（ observability.md を参照してください）。オプションの [sign]（Ed25519 アーティファクト署名）、[jwt]、[gemini]、[bedrock]、[vertex]、[image]、 [pdf]、[audio]、および [table] の追加機能も含まれません。署名なしのデフォルトの実行では これらをインポートしません。コーデックは追加機能です。コアのインストールはテキストのみです。テーブル操作には Pandas はオプションであり、標準ライブラリで十分です。

次に cp .env.example .env を実行し、ご自身のキーを貼り付けてください。組み込みツールのみを使用するコアのワークフローでは、追加機能、キー、または Node.js は不要です。

docker compose run --rm readyagents run examples/calc_pipeline.yaml
make smoke

このリポジトリに含まれないもの

常時稼働パックはウェイトリスト制であり、販売していません。

常時稼働／継続的なワーカーは Core に含まれません。オプションの readyagents-pack-continuous ディストリビューション（別リポジトリ。Core の追加機能ではありません）を使うと、明示的なフォアグラウンドコマンドから、設定済みのワークフローを実行できます。Core をインストールしても、スケジューラーやリスナーは起動しません。

ホスト型のコントロールプレーン。ホスト型の復旧機能とリモート実行ストア。SSO、マルチテナントチーム、課金。

Core にはローカルでの単発実行向けに、永続化、再開、承認待ちによる一時停止機能があります。常時稼働することはありません。

ライセンス

Apache License 2.0。LICENSE を参照してください。

セキュリティ

脆弱性は SECURITY.md の説明に従って報告してください。公開連絡先：[email protected]。API キーをコミットしないでください。.env などのローカルの運用者用ファイルは gitignore の対象です。