Is sapper-v2 still maintained?

Yes, active. Last change today. Latest release v18-champion, 8 days ago.

Can I trust sapper-v2?

New, little track record. 1.8k stars, 1 months old. Look at the code and the owner before running it.

How to install on macOS

N1nEmAn/sapper-v2

Autonomous pentest legion — AI commander + worker swarm + layered fact-intent graph. 3rd Tencent Intelligent Attack-Defense online champion (634 teams · 8h unattended · 1B tokens beat 4.5B). The Nüwa Test: give AIs Create/Language/History, let a civilization grow.

Shell scripts#ai-agents#autonomous-agents#claude-code#ctf

Difficulty: Easy
Time: about 5 min
Stars: ★ 1,771
Activity: Updated this month

Before you start

Is it free?: YesOpen source (MIT).
Still maintained?: Yes, activeLast change today. Latest release v18-champion, 8 days ago.
Can I trust it?: New, little track record1.8k stars, 1 months old. Look at the code and the owner before running it.

Saved setup from 2 h ago

Will it work on macOS?

Yes, it runs on macOS

You'll build it yourself with Docker.

Your system

macOS Windows Linux

Setup script in the repo

The maintainers included install.sh. Run it from the cloned folder after reading it.

bash install.sh

Before you start: 6. Quick Start

bash install.sh                      # symlink the sapper CLI (stdlib-only, zero deps)
sapper setup --goal "assess http://target" --agents
sapper status                        # board & frontier

Docker (the full legion):

# Option A: build from source
docker build -f docker/Dockerfile.commander -t sapper:latest .

# Option B: download the pre-built image (~1.2GB, full Kali toolchain + sapper + offline KB)
# → [Release v18-champion](https://github.com/N1nEmAn/sapper-v2/releases/tag/v18-champion)
docker load < sapper-v18-mixed.tar.gz

Environment variables (model gateways / key pool / budget): docker/ENV.md.

Single-graph operation, the fact-intent CLI, and multi-challenge sweeps: see SKILL.md.

3 steps on macOS

Download setup.sh

Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.

Clone the repository

Needs Git: xcode-select --install

git clone https://github.com/N1nEmAn/sapper-v2.git
cd sapper-v2

Install the required tools

Docker

brew install --cask docker  # Docker Desktop

Follow the README: 6. Quick Start

In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.

bash install.sh                      # symlink the sapper CLI (stdlib-only, zero deps)
sapper setup --goal "assess http://target" --agents
sapper status                        # board & frontier
docker build -f docker/Dockerfile.commander -t sapper:latest .
docker load < sapper-v18-mixed.tar.gz

If you see Cannot connect to the Docker daemon: start Docker Desktop (or the Docker service) first.

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Reading the repo

Opening the box…

N1nEmAn/sapper-v2

Shell scripts#ai-agents#autonomous-agents#claude-code#ctf

# Option A: build from source docker build -f docker/Dockerfile.commander -t sapper:latest . # Option B: download the pre-built image (~1.2GB, full Kali toolchain + sapper + offline KB) # → [Release v18-champion](https://github.com/N1nEmAn/sapper-v2/releases/tag/v18-champion) docker load < sapper-v18-mixed.tar.gz

bash install.sh # symlink the sapper CLI (stdlib-only, zero deps) sapper setup --goal "assess http://target" --agents sapper status # board & frontier docker build -f docker/Dockerfile.commander -t sapper:latest . docker load < sapper-v18-mixed.tar.gz