Pentest-Swarm-AI

环境要求

• Node.js ≥ 16（使用 npm 安装方式时）
• macOS 或 Linux 系统（使用 curl 一键脚本时）
• Go 工具链（使用 go install 时）
• Docker（使用 Docker 镜像或启动内置漏洞靶场时）
• 可选的 AI 提供商密钥（Together AI / Claude / OpenAI / Gemini），或使用本地 Ollama / LM Studio 则无

安装与启动步骤

1. 1安装工具

   README 提供 5 种安装方式，按你已有的环境任选一条执行即可，不必全部运行。

   npm install -g @armurai/pentestswarm
   curl -fsSL https://raw.githubusercontent.com/Armur-Ai/Pentest-Swarm-AI/main/scripts/install.sh | sh
   brew install Armur-Ai/tap/pentestswarm
   go install github.com/Armur-Ai/Pentest-Swarm-AI/cmd/pentestswarm@latest
   docker run --rm ghcr.io/armur-ai/pentestswarm:latest --help

   复制

2. 2启动主程序

   执行 run 会打开交互式 TUI 启动器，无需记忆任何命令行参数，全部在界面里完成。

   pentestswarm run

   复制

3. 3选择 AI 提供商

   在 TUI 中挑选提供商并直接粘贴密钥：Together AI、Claude、OpenAI、Gemini，或完全本地的 Ollama / LM Studio（无需密钥）。

4. 4指定攻击目标

   可以填一个 URL，也可以选择内置的合法漏洞靶场（cRAPI、Juice Shop、VAmPI、DVGA），靶场会自动拉起、被攻击并在结束后销毁。

5. 5选择实时视图

   默认同时开启两种视图：localhost:7777 的 Web 仪表盘，以及带实时图表、蜂群拓扑图和分级 findings 流的终端 TUI。

6. 6启动蜂群

   点击启动后观察多智能体协同工作；启动器会先做就绪检查（Go、Docker、工具、提供商），缺失项只提示不阻塞。

关键配置

如何确认成功

启动后浏览器打开 localhost:7777 能看到 Web 仪表盘，终端 TUI 同步显示蜂群拓扑与实时 findings 流。

常见问题

注意事项

• 仅对你拥有明确授权的目标进行测试，避免法律风险。
• README 强调开箱即用：一条命令安装、一条命令运行，无需初始 Key 或云服务。
• 默认同时开启 Web 仪表盘和终端 TUI 两种实时视图。
• 内置靶场（cRAPI、Juice Shop、VAmPI、DVGA）会自动创建并在结束后销毁，适合零配置试跑。