SWE-AF

环境要求

• 已安装 AgentField 控制平面（af CLI ≥ 0.1.87）
• 一个 LLM 密钥：ANTHROPIC_API_KEY 或 OPENROUTER_API_KEY（二选一）
• 本地源码安装需 Python 3.12
• 可选：GH_TOKEN（用于克隆私有仓库、推送分支、开 PR）

安装与启动步骤

1. 1安装控制平面

   SWE-AF 运行在 AgentField 之上，需先装控制平面；也可改用 Railway 一键部署。新用户从这里开始。

   curl -fsSL https://agentfield.ai/install.sh | bash

   复制

2. 2安装 SWE-AF

   直接从 GitHub 安装，自动克隆仓库、创建隔离的 Python 环境并注册 swe-planner 节点，无需手动 clone。

   af install https://github.com/Agent-Field/SWE-AF

   复制

3. 3首次运行填密钥

   首次运行会提示输入唯一的必需密钥（ANTHROPIC_API_KEY 或 OPENROUTER_API_KEY），加密存储且所有节点复用，只需输入一次。

   af run swe-planner

   复制

4. 4触发一次构建

   用 af call 流式查看进度并打印结果；goal 与 repo_url 是必填输入，返回的 branch 字段即交付产物。

   af call swe-planner.build --in '{
     "goal": "Add JWT auth",
     "repo_url": "https://github.com/user/my-repo"
   }'

   复制

5. 5本地源码安装

   不用 af install 时，可克隆源码后建虚拟环境并安装依赖，README 要求 Python 3.12。

   python3.12 -m venv .venv
   source .venv/bin/activate
   python -m pip install --upgrade pip
   python -m pip install -e ".[dev]"

   复制

6. 6本地启动服务

   先启动控制平面（监听 8080），再另开终端启动节点，注册的节点 id 为 swe-planner。

   af
   python -m swe_af

   复制

7. 7curl 调用接口

   不用 CLI 时可直接 POST 异步执行接口；如需指定开源运行时，在 input.config 中设置 runtime 与模型。

   curl -X POST http://localhost:8080/api/v1/execute/async/swe-planner.build \
     -H "Content-Type: application/json" \
     -d @- <<'JSON'
   {
     "input": {
       "goal": "Add JWT auth",
       "repo_url": "https://github.com/user/my-project",
       "config": {
         "runtime": "open_code",
         "models": {
           "default": "openrouter/minimax/minimax-m2.5"
         }
       }
     }
   }
   JSON

   复制

关键配置

如何确认成功

返回 JSON 中 success 为 true、outcome 为 completed，并给出 branch、commits、files_changed；运行中可查 /api/v1/executions/<execution_id>/no

常见问题

注意事项

• af 版本需 ≥ 0.1.87，老版本可能不支持 af install / af call 用法。
• 密钥只在首次 af run 时提示输入，之后加密存储并在所有节点间复用。
• 交付物是结果里的 branch 字段（如 issue/xxx），不是直接生成在你当前分支上。
• README 节选被截断，config 完整键名与 Docker 细节请以仓库官方文档为准。