Skip to content
TyrusRCPublic

About

Reverse engineering platform for desktop and mobile binaries. Many backends, one beast

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

Chimera

Reverse-engineering platform for desktop and mobile binaries. Many backends, one interface.

License: Apache 2.0 Python Platform Docker MCP

Chimera is a unified wrapper around Ghidra, radare2, jadx, Frida, capa, YARA and a growing set of platform-specific tools. It analyzes Windows PE / .NET, Linux ELF, macOS Mach-O, Android APKs and iOS IPAs through one CLI, one project store and one HTTP API — no LLM required — and exposes an MCP server so Claude or any compatible model can drive the pipeline.

Features

  • Cross-platform static analysis — PE / .NET, ELF, Mach-O, APK, IPA, WASM and firmware: triage → decompile → annotate → patch → export.
  • Desktop / native RE — r2 and Ghidra decompilers, a FLIRT-style library-function matcher, persistent renames/comments/types, byte-level patching with anti-debug recipes, UPX + generic PE auto-unpack (unipacker), packer detection, and a gdb symbol bridge.
  • Mobile RE — APK/IPA pipeline, manifest/NSC hardening findings, protection detection (root/jailbreak/Frida/debugger/packer), Frida instrumentation, and Flutter (B(l)utter) / React Native (Hermes) extraction.
  • Solving primitives — symbolic execution (angr), emulation (unicorn raw + Qiling OS/API-level), CFG deflattening, dispatch-table recovery, crypto/RSA/AES helpers, YARA solving.
  • Binary exploitation — checksec, GOT/PLT extraction, ROP gadget finder (14 presets), vulnerability pattern detection (18 patterns), mutation fuzzer, crash analysis with De Bruijn offsets, GDB-based AppCall, heap analysis.
  • Malware analysis — IoC extraction, CobaltStrike beacon config parsing, .NET RAT config extraction (XWorm/AsyncRAT/Warzone), API hash resolution (DJB2/CRC32/ROR13), shellcode triage, YARA rule generation, anti-analysis detection, multi-layer script deobfuscation, packer detection, DLL sideload detection.
  • Memory & firmware — Volatility memory triage, firmware carving (UEFI volumes + general router/IoT/embedded-Linux images via unblob), ELF core-dump triage, Docker/OCI container extraction.
  • Sibling tools — mantis SAST integration (RE→SAST bridge with native C/C++ rules), centurion mobile toolkit bridge (42 tools for Android/iOS analysis).
  • AI-assisted (optional, opt-in) — LLM-backed decompiler refinement and naming, VarBERT variable recovery, and the EMBER malware classifier. None of this runs on the default analyze path.

Install

Chimera runs on bare metal. Requires Python 3.12+. External tools (radare2, jadx, Ghidra, Frida, …) are discovered on PATH and skipped gracefully when absent.

git clone https://github.com/TyrusRC/chimera.git
cd chimera
scripts/setup.sh           # full install: venv + all pip deps + apt tools + sibling projects
scripts/setup.sh --update  # update: git-pull chimera + siblings, then reinstall/upgrade everything
scripts/setup.sh --check   # dry-run: show what's installed and what's missing
scripts/setup.sh --yes     # non-interactive: never prompt (apt skipped if sudo needs a password)

The setup script installs the full toolkit by default: RE (radare2, jadx, gdb), exploit (pwntools, ropper, frida, keystone), malware analysis (yara, capa, floss), and the sibling projects mantis (SAST) and centurion (mobile). Siblings live next to chimera (../mantis, ../centurion): setup clones them if missing and installs them editable, so a git pull in a sibling takes effect immediately. Use --minimal for just the venv + core Python deps.

Updating. Re-run scripts/setup.sh --update. It fast-forwards chimera and each sibling (git pull --ff-only; local commits or uncommitted work are never overwritten, a diverged checkout is reported, not merged), then upgrades the Python, apt and npm tools. To update just one sibling, git -C ../mantis pull is enough (it's editable); re-run setup only when its dependencies changed.

If setup seems stuck. Each step prints its elapsed time, and the full output goes to .setup.log; run tail -f .setup.log in another terminal to watch it. angr legitimately takes minutes to build. A failed step is listed at the end rather than aborting the run, and re-running is safe.

The siblings are not on PyPI. The centurion package on PyPI is unrelated, and mantis-sast is unregistered. Install them via setup.sh or the git-pinned extras (pip install 'chimera[sast,mobile]'), never pip install centurion.

chimera doctor          # external-tool + environment health check, with install hints
chimera analyze app.apk
chimera install         # register chimera with your MCP agent hosts

Docker (isolation sandbox)

For reversing an untrusted target in a disposable environment. The image bundles pinned radare2, jadx and Ghidra:

docker compose up -d
docker run --rm -v "$PWD:/projects" chimera:latest analyze /projects/app.apk

Usage

chimera analyze app.apk                    # full pipeline (PE/ELF/Mach-O/APK/IPA)
chimera analyze app.ipa --ghidra-home /opt/ghidra
chimera detect-protections app.apk         # root/jailbreak/Frida/debugger/packer
chimera manifest app.apk --format json     # Android manifest + NSC findings
chimera diff <sha-a> <sha-b>               # compare two analyses
chimera sdks app.apk                        # third-party SDKs
chimera patch target.exe --nop 0x401000    # byte/asm patching (dry-run by default)

Run chimera --help for the full command set.

MCP (140 tools)

Chimera exposes an MCP server so an agent (Claude Code or any MCP client) can drive the whole pipeline. Register it with chimera install.

Module Tools Purpose
session 5 analyze, status, multi-binary session
query 19 functions, strings, imports, sections, callgraph, xrefs, disasm, diff, struct recovery
detection 13 protections, framework, SDKs, protocols, capa, FLOSS, YARA
annotate 7 rename, comment, type, classify, note, batch
exploit 19 checksec, GOT/PLT, ROP, vuln scan, fuzzer, crash, AppCall, heap, Sigma/Suricata authoring
solving 24 decompile, symexec, emulate, patch, crypto, RSA attacks, PRNG, MBA, cfg, pathfind, pcap (HTTP + JA3/JA4)
unpacking 15 PyInstaller, Docker, Node, Tauri, Flutter, .NET, WASM, firmware (UEFI + unblob), PE auto-unpack
dynamic 12 AFL++, dotnet-trace, emulate, Qiling OS-emulation, Wine, sandbox, breakpoints, QEMU
external 3 mantis SAST, centurion mobile (list + run)
frida 7 spawn, attach, exec, load script, messages
devices 7 adb connect, packages, logcat, proxy, pull
vm 7 QEMU VM lifecycle (snapshot, revert, start, stop, exec)
skills 2 list + get chimera workflow skills

Environment knobs: CHIMERA_MCP_MAX_REPLY_BYTES (default 100000). A larger reply is saved under chimera_project/replies/ and returned as a preview plus the file path. CHIMERA_MCP_FAMILIES (csv, e.g. query,solving) advertises only those tool families, plus session and skills.

12 workflow skills ship with chimera: re-workflow, exploit-workflow, malware-triage, desktop-re, mobile-re, dynamic-analysis, crypto-re, sandbox, sast-bridge, sast-workflow, python-bytecode, gpu-acceleration.

Dependencies

scripts/setup.sh installs everything — no optional tools. Run chimera doctor for the health check.

License

Apache License 2.0.

About

Reverse engineering platform for desktop and mobile binaries. Many backends, one beast

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages