jiwoochris/artex-global

ARTEX – グローバル版

概要 – 大規模言語モデル（LLM）エージェントが偵察からデータ流出まで完全なセキュリティ評価を実行できる、オープンソースの自律ペネトレーションテストプラットフォームです。システムは単一の Go バイナリとして構築され、Next.js Web UI を埋め込み、すべての結果を PostgreSQL に保存します。

主な機能

• LLM 駆動のマルチエージェントワークフロー – プランナーがテスト目標をサブタスクに分解し、複数のワーカーエージェントが実際のツール（nmap、curl など）を実行し、レポーターが結果を資産と脆弱性のグラフに集約します。
• ヒューマン・イン・ザ・ループチャット – オペレーターは実行中に介入、ヒント提供、または要約要求ができます。
• 多言語出力 – ユーザー向けの結果、レポート、チャット応答は英語、韓国語、中国語、またはスペイン語で表示できます。内部推論プロンプトはモデル性能を維持するため元の言語のままです。
• 設定可能な LLM バックエンド – Anthropic、OpenAI、または OpenAI 互換のエンドポイントで動作します。モデルとトークン制限は UI または環境変数で調整可能です。
• 組み込みツール – Docker イメージには一般的なセキュリティユーティリティ（nmap、ripgrep、curl など）と、後で強化するためにすべてのコマンド出力をキャプチャするトラフィック記録 MITM プロキシが同梱されています。
• 防御リソース – リポジトリには、署名、強化チェックリスト、自律 AI 攻撃を検出するための推奨事項を含む「防御と検出ガイド」が含まれています。

アーキテクチャ概要

フロントエンド（Next.js）←埋め込み→ Go サーバー ←→ PostgreSQL
   │                         │                │
   └─ REST API + SSE        └─ エンジン（プランナー + N ワーカー）
                              │
                              └─ norma SDK エージェント（目標分解、実行）

• UI はタスク、資産、カバレッジグラフ、アクティビティストリームを視覚化します。
• エンジンはプランナーループとワーカー goroutine をスケジュールし、すべてのデータを 2 つのグラフに永続化します：資産グラフ（ターゲット、発見されたサービス）と探索グラフ（実行された手順、ツール出力）。
• サポートサブシステムは、トラフィックプロキシ、ツール承認ガード、DNS/HTTP 強化、拡張可能な「スキル」モジュールを処理します。

はじめに

1. リポジトリをクローンし、.env.example を .env にコピーします。
2. PostgreSQL パスワードを提供し、必要に応じて Anthropic または OpenAI API キーを提供します。
3. docker compose up -d を実行します – これにより artex コンテナと PostgreSQL インスタンスが起動します。
4. http://localhost:8787 を開き、表示されたセットアップトークンを使用して 1 回限りの管理者設定を完了し、タスクの作成を開始します。

代替インストール – インストールスクリプト、プリコンパイル済みバイナリ、または手動の go build -tags embedui も機能します。

安全通知 – このツールは意図的に強力です。実際のエクスプロイトを実行できます。リポジトリには顕著な誤用警告が含まれ、AGPL‑3.0 でリリースされ、認可されたテストのみを許可する追加の使用制限条項が付いています。著者は、このソフトウェアが防御者が自律 AI 攻撃を理解し検出するためのものであることを強調しています。

技術スタック

• バックエンド： Go（net/http、go:embed）と LLM エージェント用の norma SDK。
• フロントエンド： Next.js（静的ビルド）をバイナリにバンドル。
• データベース： PostgreSQL。
• コンテナ化： Docker + Docker‑Compose。
• LLM 統合： Anthropic または OpenAI 互換 API（環境変数または UI で設定可能）。
• バンドルツール： nmap、curl、ripgrep、vim、npm、およびカスタム「スキル」スクリプト。

ライセンス – AGPL‑3.0 に加え、認可された環境での使用に制限し、悪意のある悪用を禁止する追加の免責条項が付いています。

---

この要約はリポジトリの README のみに基づいています。外部情報は追加されていません。