Skip to content
pet6rPublic

About

Agentic reverse engineering pipeline that turns a dropped binary into a structured triage report with MITRE ATT&CK mapping, IoCs, YARA rules, and a SOC-actionable verdict. Built on top of Ghidra.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Theseus

Navigate any binary.

AI-assisted reverse-engineering pipeline. Drop a binary, get a structured triage report with MITRE ATT&CK mapping, IoCs, and a SOC-actionable verdict.

Built on:

Architecture

GUI (DearPyGui)
   |
   v
orchestrator.py  ---->  Anthropic Claude (Agent SDK)
   |                         |
   |                         | tool calls (ghidrasql HTTP)
   v                         v
headless Ghidra <--- LibGhidraHost HTTP :18080
   (analyzeHeadless + LibGhidraHeadlessServer.java)

Phases (each = focused prompt, JSON output):

  1. Triage — funcs/imports/strings overview, pack detection, suspicion score
  2. Capability — MITRE ATT&CK technique mapping with evidence
  3. IoC — URLs, IPs, mutex, regkey, paths (xref-validated)
  4. Verdict — clean / suspicious / vulnerable (BYOVD) / malicious / unknown + SOC action recommendation

Final output: report.json (schema in schema/report.schema.json) plus an HTML reveal.js deck for demos.

Install

Prereqs:

git clone <this-repo> theseus
cd theseus
python -m venv .venv && source .venv/bin/activate   # or .venv\Scripts\activate on Windows
pip install -r requirements.txt
cp .env.example .env   # fill in ANTHROPIC_API_KEY, GHIDRA_HOME

Usage

CLI:

theseus run path/to/binary.exe                # single binary, prints + writes report.json
theseus run binary.exe --deck report.html     # also generate reveal.js demo deck
theseus serve --port 8090                     # HTTP API for SOC ingest

GUI:

theseus gui

Drop a binary on the window. Watch the pipeline tabs fill. Open the deck when done.

SOC integration

# Push verdict to a SOAR webhook
theseus run binary.exe --webhook https://soar.internal/ingest

JSON output is schema-stable. See schema/report.schema.json.

Sample data

About

Agentic reverse engineering pipeline that turns a dropped binary into a structured triage report with MITRE ATT&CK mapping, IoCs, YARA rules, and a SOC-actionable verdict. Built on top of Ghidra.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages