Skip to main content

Sui

Suijin

Your team of fully autonomous web app pentesters and red teamers for any situation.

version license python


Developer's Note and Practical Note

⭐️ Please leave a star if you liked Suijin!

Hello and thanks to everyone who's reading this! I'm William, the dev behind Suijin. It's taken months to build Suijin and it is the culmination of my knowledge of web app pentesting and systems knowledge.

Glad to see that you might be giving Suijin a change to help you with your pentesting workflows or bug bounty hunting!

I personally use Suijin almost every day, mostly benchmarking runs and real engagements and it has shown real results and found many CVEs and earned me lots of real-world reputation with bug bounty programs and vulnerability disclosure programs.

But on a practical note, Suijin is still very much in development and I am actively building and shipping improvements and bug fixes.

If you do encounter any bugs or issues please open an issue or email me directly at jiangwilliam30@gmail.com or DM me on X @0xwi11iam. If you'd like to, pull requests are accepted and greatly appreciated.

Thank you so much!

made with ❤️ by 0xwi11iam

pfp

 

 

You tell it what to test. It spawns subagents, maps out the attack surface, discusses attack surfaces with the other sessions and gets hacking ! It runs the engagement — recon, exploitation, post-exploitation, report — like a pentester who never gets tired, never skips the boring surfaces, and proves every finding by running the exploit before claiming it, all while you supervise from a beautiful Operator Console watching over what what everyone on the team is doing.

 

Who it's for

  • Bug bounty hunters who can load the program rules, point Suijin at in-scope targets, and get back verified findings — not "the model thinks there's an IDOR here," here's the POC, the output, the marker.
  • Pentest teams running authorized engagements. One agent per target, or a whole team on one target — they split lanes, share dead ends, and never re-burn a payload a peer already ruled out.
  • CTF players. Flip the profile and the doctrine changes: the flag is the objective, a confirmed bug is a stepping stone, persistence prioritised over tidiness.
  • Security researchers who want an agent platform that grades itself — onboard labs with chain-verification tests and bench scoring, so "did my change make the agent better" is a number, not a vibe.

 

What a run looks like

1. Start it.

suijin lab up
suijin
(mode: type 1)
target: 127.0.0.1:6000

It maps the surface, probes, exploits, escalates to as far as it can go, and writes the report — narrating its reasoning in your terminal the whole way. You can interrupt at any point to redirect it; it can pause between turns, resume saved runs, and pick up an engagement weeks later from its .sje snapshot.

2. Or start a team. Open one terminal per agent. Sessions on the same target find each other, introduce their lanes, and coordinate — while agents on different targets are kept strictly apart.

3. Watch from one screen.

the Suijin operator console — agent cards, details, overview with the Sui mascot, mesh feed, and the command line

suijin operator

Every running agent on one dashboard: live cards, iteration history, confirmed exploits, the team's chat. Keyboard-first — tab cycles panels, j/k pages the roster, ←→ walks any agent's iteration history. The input box is a command line:

/say <msg> talk to the whole team
/pause [msg] hold every agent between turns, with a message they read on resume
/su <hex> become an agent — /state /cost /findings, change its objective, or type guidance straight into its context
/exploits /tail /sort /filter inspect and rearrange the field

4. Trust the output. A finding only counts when its POC ran and the target produced the expected marker — unique, target-derived strings; 200 OK proves nothing. No match means the exploit comes back with every command and output attached so you can fix or drop it. A finding without a cataloged POC is a rumor.

5. Come back tomorrow. Suijin remembers: blocked patterns, WAF rules, false positives, dead batteries, what worked where. The next engagement — same target or same tech — starts with all of it and skips the graveyard.

 

Comparison

Suijin non-specialised agents
Findings are terminal-verified POCs model claims
Ending the run structurally refused while surfaces are untested up to the model
Parallel agents session mesh — lane claims, shared dead ends, cross-target isolation separate chats
Dead ends remembered cross-engagement re-tried tomorrow
The operator one command center — pause, steer, impersonate any agent N terminals

 

Safety first

New to it — or new to the agent? Run it against the onboard lab: a multi-service target (15 named services behind a gateway/auth/core plane, ~100+ vulnerability instances, cross-service chains, decoys, 22 flags) that runs on your machine. Sharpen against something that can't get you arrested.

suijin lab up
suijin
press 1
press 1
target: 127.0.0.1:6000

 

Quick start

# one command (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/0xwi11iam/Suijin/main/install.sh | bash

# first engagement
suijin engage "http://127.0.0.1:6000 — full assessment"

# watch every agent from one screen
suijin operator
install — all methods
# pipx / uv (installable package)
pipx install suijin

# manual
git clone https://github.com/0xwi11iam/Suijin
cd Suijin && pip install -e .

# dev install (live local copy)
pip install -e ".[dev]"

# docker (turnkey)
docker build -t suijin .
CLI reference
group verbs
engage engage exploit resume load plan replay panic
operator operator tui attach ps stop daemon suijind mesh-port
knowledge kg kb recipes wordlist pull creds bb-scope
workspace workspace sessions reports export clean
system doctor selftest status version env providers config install lab bench pack capability tools modules module skills profile prompt theater market gateway tokens rules policy notify compliance authorize

 


Authorized security testing only.
On a more serious note, never point Suijin at a system you do not own or lack written permission to test. Unauthorized access is illegal — you accept full responsibility for what you run.

Licensed under AGPL v3.0 · Suijin · By 0xwi11iam(William Jiang)

Metadata

Release files for suijin 7.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for suijin 7.0.0
File Size Uploaded
suijin-7.0.0.tar.gz 1.0 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for suijin 7.0.0
File Interpreter ABI Platform
suijin-7.0.0-py3-none-any.whl Python 3 none any Details

Total release size: 2.5 MB

Release files / suijin-7.0.0.tar.gz

Download URL suijin-7.0.0.tar.gz
Size 1.0 MB
Tags Source
SHA-256 checksum
How to use checksums
ae48c58a4d0bf06ff7db02cc6517ee98b9de3d49d1de242a43011ba15badd9af
BLAKE2b-256 checksum
How to use checksums
cd33cea1fee25ac7e410118c5c8c6017e71e60f4c2c99d820acd8e2783fc441c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release files / suijin-7.0.0-py3-none-any.whl

Download URL suijin-7.0.0-py3-none-any.whl
Size 1.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums
1fa4f969f58e133b5df2c7f843c202480fdecfdf39832a4adb86974b1b941ee0
BLAKE2b-256 checksum
How to use checksums
6f562e067d8024d6c00274a280a302f2f8cb7549898148ebbea06be578ba568f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release history Release notifications | RSS feed

7.1.0

2 release files

This release

7.0.0 This release

2 release files

6.9.0

2 release files

6.8.0

2 release files

6.7.0

2 release files

6.6.0

2 release files

6.5.0

2 release files

5.7.0

2 release files

5.6.1

2 release files

5.6.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page