Evidence-focused malware reverse engineering with deep PE/.NET inspection, Ghidra reconstruction, AI cross-checks, YARA, and ELF debugging
Evidence-focused reverse-engineering CLI. Andrey Pautov develops the Python analyst interface, offline triage, string intelligence, PE inspection and reporting workflows. Capstone, Ghidra, GDB and optional AI providers are integrations, not original tools authored by this project.
Role relevance: Malware triage, reverse engineering tooling, safe AI-assisted analysis, Python delivery.
Run the safe local demo and review validation scope · Recorded local validation
AIDebug is an evidence-focused malware reverse-engineering CLI and terminal UI. It combines deterministic offline triage, whole-file hex inspection, deep PE structure analysis, Capstone disassembly, Ghidra reconstruction, optional LLM cross-checks, local ELF debugging, compiled learning exercises, and analyst-review reporting.
Current source version: AIDebug 3.1.0. See the 3.1.0 release notes.
The latest immutable published release remains AIDebug v3.0.0, available as
1200km-aidebug, until the version-matched 3.1.0 tag and GitHub release complete the verified publishing workflow.
Install the stable package from PyPI in these three steps:
python3 -m venv .venv
source .venv/bin/activate
Run the version-aware secure pip bootstrap in that environment. It preserves newer pip versions and verifies the pinned wheel's hash when an upgrade is needed. Stop if it fails; do not continue to package installation.
Install the stable package:
python -m pip install 1200km-aidebug==3.0.0
aidebug --version
Install optional capabilities as needed:
# LLM provider clients and local validation of AI-generated YARA candidates
python -m pip install "1200km-aidebug[ai]==3.0.0" "certifi>=2026.10.19"
# Frida dynamic instrumentation
python -m pip install "1200km-aidebug[dynamic]==3.0.0"
# All optional Python integrations
python -m pip install "1200km-aidebug[all]==3.0.0" "certifi>=2026.10.19"
String Intelligence requires source 3.1 until its package is published. The
3.1 review
pins the revision below. Its runtime code also matches the audited October 1
main revision 80b0b7172b592814504c405a16bf4cc0ce4161eb.
git clone https://github.com/anpa1200/AIDebug.git
cd AIDebug
git checkout cd81ef242db0bcea3296970d45c241a4228d2d27
python3 -m venv .venv
source .venv/bin/activate
Before installing dependencies, run the version-aware secure pip bootstrap in this environment. The historical checkout does not include the current bootstrap helper. Stop if bootstrap fails. Continue only after it succeeds:
python -m pip install -e .
aidebug --version
From that checkout, add extras with python -m pip install -e ".[ai]" "certifi>=2026.10.19",
".[dynamic]", or ".[all]" "certifi>=2026.10.19". Keep extras on the same installation track:
installing "1200km-aidebug[ai]==3.0.0" over source 3.1 can replace it with
the published 3.0 package.
For a moving development checkout:
git clone https://github.com/anpa1200/AIDebug.git
cd AIDebug
python3 -m venv .venv
source .venv/bin/activate
python scripts/bootstrap_pip.py
python -m pip install -e ".[dev,dynamic]"
Ghidra, GDB, Bubblewrap, a C compiler, and Frida target components are external tools used only by the workflows that require them.
AIDebug was accepted into REMnux on 7 October 2026 through
PR #355, first included in
salt-states v2026.41.4.
The accepted state
installs unpinned 1200km-aidebug[ai] from PyPI into /opt/aidebug, enables
upgrades, and exposes /usr/local/bin/aidebug. As verified on 8 October 2026,
PyPI still provides 3.0.0; this does not install unpublished 3.1 source or the
dynamic extra. Use --offline to keep analysis local.
See REMnux setup and version boundaries.
Open a PE or ELF sample in the main terminal interface:
aidebug --binary /path/to/sample.exe --offline
Run deterministic analysis without the full-screen UI and export evidence:
aidebug --binary /path/to/sample.exe \
--offline --no-tui --report --json-export --yara \
--out-dir reports/
Use Ghidra reconstruction:
aidebug --binary /path/to/sample.exe --offline --no-tui --decompile
aidebug --binary /path/to/sample.exe --offline --no-tui \
--decompile-all reports/sample-reconstruction.c
Analyze one C translation unit through a temporary, non-executed ELF artifact:
aidebug --source /path/to/example.c --offline --no-tui
Identify an arbitrary file independently of its filename extension:
aidebug --identify /path/to/renamed-or-unknown-file --offline