🏹 ARTEMIS

Automated Red Teaming Engine with Multi-agent Intelligent Supervision

ARTEMIS是由斯坦福Trinity项目开发的自主智能体，用于自动化漏洞挖掘。

快速入门

如果您尚未安装 uv，请先进行安装：

curl -LsSf https://astral.sh/uv/install.sh | sh

安装最新版本的 Rust（构建所需）：

# 如果之前通过 apt 安装过旧版 Rust，请先移除
sudo apt remove rustc cargo
sudo apt install libssl-dev

# 安装官方的 Rust 工具链管理器 rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 重启终端或重新加载环境变量
source ~/.cargo/env

# 安装最新稳定版 Rust
rustup install stable
rustup default stable

首先，我们需要构建 codex 二进制文件：

cargo build --release --manifest-path codex-rs/Cargo.toml

接下来，我们可以设置 Python 环境：

uv sync
source .venv/bin/activate

环境配置

复制示例配置文件并添加您的 API 密钥：

cp .env.example .env
# 编辑 .env 文件，填入您的 API 密钥

所需的环境变量：

• OPENROUTER_API_KEY 或 OPENAI_API_KEY - 用于监督模块和 LLM 调用
• SUBAGENT_MODEL - 用于生成的 Codex 实例的模型（例如：anthropic/claude-sonnet-4）

快速测试运行

尝试一个简单的 CTF 挑战来验证一切是否正常工作：

python -m supervisor.supervisor \
  --config-file configs/tests/ctf_easy.yaml \
  --benchmark-mode \
  --duration 10 \
  --skip-todos

这将在基准模式下运行一个持续 10 分钟的简单 CTF 挑战（不进行分类处理）。

有关详细的配置选项和使用方法，请参阅 supervisor-usage.md。

---

Docker

Docker 快速入门

构建 Docker 镜像：

docker build -t artemis .

环境配置

与上述相同——复制示例配置文件并添加您的 API 密钥：

cp .env.example .env
# 编辑 .env 文件，填入您的 API 密钥

所需的环境变量：

• OPENROUTER_API_KEY 或 OPENAI_API_KEY - 用于监督模块和 LLM 调用
• SUBAGENT_MODEL - 用于生成的 Codex 实例的模型（例如：anthropic/claude-sonnet-4）

OpenRouter 的 Codex 配置

如果您使用 OpenRouter，则需要配置 codex 二进制文件。创建 ~/.codex/config.toml：

mkdir -p ~/.codex
cat > ~/.codex/config.toml <<'EOF'
model_provider = "openrouter"

[model_providers.openrouter]
name = "OpenRouter"
base_url = "https://openrouter.ai/api/v1"
env_key = "OPENROUTER_API_KEY"

[sandbox]
mode = "workspace-write"
network_access = true
EOF

使用 Docker 运行

使用提供的 run_docker.sh 脚本：

# 使用 OpenRouter 运行（挂载 ~/.codex/config.toml）
./run_docker.sh openrouter

# 仅使用 OpenAI 运行（无需挂载配置文件）
./run_docker.sh openai

该脚本将：

• 挂载您的 ~/.codex/config.toml（如果使用 OpenRouter）
• 挂载 ./logs 目录以保存持久化日志
• 使用您的 .env 文件中的 API 密钥
• 在一个简单的 CTF 挑战上运行 10 分钟的测试

手动运行 Docker：

如果您更倾向于手动运行 Docker：

# 使用 OpenRouter
docker run -it \
  --env-file .env \
  -v $HOME/.codex/config.toml:/root/.codex/config.toml:ro \
  -v $(pwd)/logs:/app/trinity/ARTEMIS/logs \
  artemis \
  python -m supervisor.supervisor \
    --config-file configs/tests/ctf_easy.yaml \
    --benchmark-mode \
    --duration 10 \
    --skip-todos

# 仅使用 OpenAI
docker run -it \
  --env-file .env \
  -v $(pwd)/logs:/app/trinity/ARTEMIS/logs \
  artemis \
  python -m supervisor.supervisor \
    --config-file configs/tests/ctf_easy.yaml \
    --benchmark-mode \
    --duration 10 \
    --skip-todos

---

致谢

本项目基于 OpenAI Codex 开发，并从 commit c221eab 分支而来。

---

许可证

此仓库采用 Apache-2.0 许可证授权。

ARTEMIS 快速上手指南

ARTEMIS 是由斯坦福 Trinity 项目开发的自动化红队引擎，利用多智能体监督机制自动发现系统漏洞。

环境准备

在开始之前，请确保您的系统满足以下要求：

• 操作系统：Linux 或 macOS（Windows 用户建议使用 WSL2 或 Docker）
• 前置依赖：
  • curl
  • git
  • libssl-dev (Ubuntu/Debian)
  • Python 环境（将通过 uv 自动管理）
  • Rust 工具链（用于构建 Codex 二进制文件）

注意：如果您通过 apt 安装过旧版 Rust，建议先卸载以避免冲突。

安装步骤

1. 安装 UV 包管理器

curl -LsSf https://astral.sh/uv/install.sh | sh

2. 安装 Rust 工具链

# 移除可能存在的旧版 Rust (仅限 Debian/Ubuntu)
sudo apt remove rustc cargo
sudo apt install libssl-dev

# 安装 rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 加载环境变量
source ~/.cargo/env

# 安装并设置最新稳定版 Rust
rustup install stable
rustup default stable

3. 构建 Codex 二进制文件

cargo build --release --manifest-path codex-rs/Cargo.toml

4. 配置 Python 环境

uv sync
source .venv/bin/activate

5. 配置 API 密钥

复制示例配置文件并填入您的密钥：

cp .env.example .env
# 使用编辑器打开 .env 文件，填入以下变量：
# OPENROUTER_API_KEY 或 OPENAI_API_KEY
# SUBAGENT_MODEL (例如：anthropic/claude-sonnet-4)

基本使用

完成安装和配置后，您可以运行一个简单的 CTF 挑战测试来验证环境是否正常工作。以下命令将运行一个 10 分钟的基准测试：

python -m supervisor.supervisor \
  --config-file configs/tests/ctf_easy.yaml \
  --benchmark-mode \
  --duration 10 \
  --skip-todos

说明：

• --benchmark-mode：启用基准模式，跳过分类整理过程。
• --duration 10：测试运行时长为 10 分钟。
• --skip-todos：跳过待办事项处理。

如需更详细的配置选项，请参考项目文档 docs/supervisor-usage.md。