OpenSRE — CI/CDの失敗原因を調査・修正するオープンソースのCLIエージェント
Tracer-Cloud/opensre
★ 13,166 ・ Python ・ Apache-2.0
概要
継続的インテグレーション(CI)環境でビルドやテストが失敗した際、エラーログの確認や原因調査、修正箇所の特定には多くの工数がかかります。CIツールは「何が失敗したか」を通知してくれますが、「なぜ失敗したのか」「どのように修正すべきか」までは自律的に提示してくれません。
OpenSREは、そうした課題の解決を目的としたオープンソースのCI/CD信頼性向上エージェントです。失敗した実行ログを読み取って原因を追跡し、修正案を作成してレビュー用のプルリクエストやブランチへ反映する一連の流れを支援します。
自社インフラ上でのセルフホストに対応しており、自前のモデル(LLM)を接続して運用できるように設計されています。CIの失敗調査に時間を奪われている開発チームや、インシデント対応の自動化を進めたいSRE・DevOpsエンジニアに向いています。
主な特徴
-
失敗したビルドの自動調査と修正案の作成
CI実行が失敗したタイミングでログを解析し、仮説検証を行ったうえで修正内容をブランチへプッシュしてレビューを依頼できます。 -
原因の切り分け(CI起因 vs コード起因)
環境やインフラに起因するCIエラーと、アプリケーションコード自体の不具合を分離して分析するため、再実行でごまかさず根本原因に対処できます。 -
複数の利用インターフェース
ターミナル上で対話的に使えるインタラクティブシェル(REPL)に加え、スクリプトやCIジョブに組み込めるヘッドレスCLI、Pythonコードから直接呼び出せる埋め込みAPIが用意されています。 -
機密情報のマスキング機能
外部のLLM呼び出しを行う前に、ログ等に含まれる機密性の高い識別子を自動でマスキングする機構が備わっています。 -
外部ツールとの連携
調査結果のサマリーをSlack、PagerDuty、Telegramなどのコミュニケーションツールへ直接投稿できます。
使い方
インストールと起動
事前にGitリポジトリとターミナル環境を用意します。macOSまたはLinux環境では、公式のインストールスクリプトを利用してセットアップできます。
curl -fsSL https://install.opensre.com | bash -s -- -gh
Windows(PowerShell)の場合は次のコマンドを実行します。
& ([scriptblock]::Create((irm https://install.opensre.com/install.ps1))) -gh
インストールが完了したら、opensre コマンドで起動します(初回起動時はサインインとホストモデルのアクティベーションが行われます)。
opensre
対話型シェル(Interactive Shell)
サブコマンドなしで opensre を実行すると、REPL形式の対話シェルが起動します。自然言語でインシデントの状況を尋ねたり、スラッシュコマンド(/help、/status、/cost、/sessions、/integrations list など)を用いてセッションや連携ツールを操作できます。
ヘッドレスCLI(非対話実行)
スクリプトやCIジョブなどから1ターンのみ実行したい場合は、ask サブコマンドを利用します。
opensre ask "why is checkout-api slow?"
Python APIからの利用
リポジトリをチェックアウトした環境であれば、自作のPythonスクリプトや社内サービスにエージェントセッションを組み込むことも可能です。
from surfaces.embedded import start_embedded_session
session = start_embedded_session()
result = session.chat("why is checkout-api slow?")
if result.action_result.accounting_status == "completed" and not result.cancelled:
print(result.primary_response_text)
技術的なポイント
- 言語とアーキテクチャ
実装の主言語はPythonです。リポジトリのエントリポイントマップとしてmain.pyが用意されており、以前採用されていたグラフやチェーンのフレームワーク層を刷新したエージェント構造になっています。 - 動作パイプライン
OpenSREの処理は「コンテキスト取得(CIログ、コミット、デプロイ履歴、メトリクス等)」→「機密情報マスキング」→「ツール呼び出しループによる推論と仮説検証」→「根拠付きの回答生成」→「修正のプッシュまたは是正措置の実行」→「チャットツール等へのサマリー通知」という段階を踏んで行われます。 - 多様なデプロイ形態
OpenSRE Cloudによるマネージドゲートウェイのほか、AWS EC2向けのAMIビルド(make build-gateway-image)や、リポジトリ同梱のDockerfileを使ったコンテナ展開(Railway、ECS、Vercel等)に対応しています。複数レプリカ間で状態を共有する用途にはPostgreSQL(DATABASE_URL)の接続が想定されています。
注意点
- 開発フェーズ(Public Alpha)
READMEには「Public Alpha」と明記されており、コアワークフローの初期検証は可能なものの、完全には安定していません。APIや連携機能の仕様が今後変更される可能性があります。 - ライセンス
本プロジェクトは Apache License 2.0 で公開されています。商用・非商用問わず利用可能ですが、ライセンス条項に従う必要があります。 - アカウント認証
対話シェルなどの利用にはアカウント検証が必要です。完全に閉じたローカル環境のみでどこまで動作するかについては、公式ドキュメント(opensre.com)の認証設定やセルフホスト手順を確認してください。
まとめ
OpenSREは、CI/CDで頻発する失敗ログの調査とコード修正を自動化し、開発者が本来の開発作業に集中できるように支援するPython製エージェントです。対話シェルだけでなくヘッドレス実行やPython APIも提供されているため、既存の運用フローやスクリプトへ段階的に組み込むことができます。





