whatisgithub

What is attacksaga?

sentrytrace/attacksaga — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · developerComplexity · 4/5Setup · moderate

In one sentence

An AI agent that automatically hacks a safe, legal practice target (OWASP Juice Shop) to prove security weaknesses are real.

Mindmap

mindmap
  root((AttackSaga))
    What it does
      AI attack agent
      Plan execute loop
      Proves impact
    Tech stack
      Python
      FastAPI
      Docker
    Use cases
      Practice pentesting
      Live web console
      Offline demo mode
    Audience
      Developers
      Security learners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Practice automated penetration testing against a safe, legal lab target.

USE CASE 2

Watch an AI agent's plan, execute, observe, decide loop live in a web console.

USE CASE 3

Study a working example of an LLM-driven security testing pipeline.

USE CASE 4

Run a fully offline demo without any API key or live target.

What is it built with?

PythonFastAPIDockerTyper

How does it compare?

sentrytrace/attacksaga0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity4/54/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Docker for the Juice Shop lab target and an API key unless using the offline mock mode.

No license is stated in the README, so reuse and redistribution terms are unclear.

So what is it?

AttackSaga is an AI agent that automatically finds and exploits security weaknesses in a deliberately vulnerable test application called OWASP Juice Shop, which is a free tool built specifically for practicing security testing in a safe, legal way. The agent uses a large language model to reason about each step, decide what to try next, run the action, look at the result, and repeat, working through a chain of attack steps on its own rather than requiring a human to guide every move. Safety is built in from the ground up. The tool is hard-locked to only attack targets on your own computer, localhost, and every outgoing request is checked against an allow list before it is sent. If it ever tries to reach anything outside that boundary, the run stops immediately with an error. The README is explicit that using this against any system you do not own or have written permission to test is against the law. The attack process runs through four stages: first logging in without valid credentials by exploiting a flaw in the login form, then finding a part of the application that reveals other users' data through predictable web addresses, then actually pulling another user's private information using that flaw, and finally presenting the extracted data as clear proof that the weakness is real and exploitable. To try it, you first run the Juice Shop test application locally using Docker, then install AttackSaga with Python and add an API key for the language model it uses. You can run the whole chain, just one stage at a time, or use a fully offline demo mode that replays saved responses instead of making real requests or needing an API key at all. There is also an optional local web dashboard that shows the plan, execute, and observe steps happening live, with any sensitive information like emails or tokens hidden by default until you choose to reveal it. The project describes itself as a hackathon-built but fully runnable prototype, with the offline demo mode letting anyone explore how the whole system works without needing real credentials or a live target.

Copy-paste prompts

Prompt 1
Explain how AttackSaga's ScopeGuard prevents it from attacking anything but localhost.
Prompt 2
Help me run the offline mock and dry-run demo of the full attack chain.
Prompt 3
Walk me through setting up OWASP Juice Shop in Docker to use as the target.
Prompt 4
Show me how to run just the IDOR exploit phase of the attack chain.

Frequently asked questions

What is attacksaga?

An AI agent that automatically hacks a safe, legal practice target (OWASP Juice Shop) to prove security weaknesses are real.

What language is attacksaga written in?

Mainly Python. The stack also includes Python, FastAPI, Docker.

What license does attacksaga use?

No license is stated in the README, so reuse and redistribution terms are unclear.

How hard is attacksaga to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is attacksaga for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.