python-reverser-patterns
Reverse binaries and Python artifacts with Python: parse ELF/PE, disassemble with pwntools/capstone, instrument with Frida, recover .pyc and PyInstaller payloads. Use when analyzing malware, packed Python, stripped binaries, or runtime hooks — not for CPython language style (python-patterns).
v2026.11.13-21cd5683 installs+3 in 7 days39 StarsMITsynced 11 hours ago
Install
No NotHoly CLI yet? Install it first.
$ curl -fsSL https://notholy.com/install.sh | sh$ notholy skills install aeondave/python-reverser-patternsWrites to ~/.notholy/skills after checking the signature and the SHA-256.
SignatureSigned, ed25519
Package0dee733e…9c0b4dda
0dee733e054c…1cbe9c0b4dda8 files · 11.7 KBScanLow1 finding
- Links to outside domains
Sourcegithub.com/AeonDave/malskill/tree/main/coding/python-reverser-patterns@21cd568
On this page
Hands-on reversing with Python: ELF/PE parsing, strings/imports/entropy, disassembly, Frida, and Python bytecode (.pyc / PyInstaller). Language idioms belong in python-patterns.
When to activate
- Mapping why an ELF/PE fails, what malware does, or how a stripped binary is laid out.
- Extracting strings, imports, entropy regions, entrypoints, section flags.
- Instrumenting runtime with Frida (host Python, hooks in GumJS).
- Recovering logic from
.pyc,__pycache__, or a PyInstaller/py2exe-style bundle. - Diffing two binary versions (hardening, packing, payload change).
Core principles
- Triage before disassembly: strings, imports, entropy, then hotspots.
- Match interpreter to bytecode:
marshal/disonly on the same CPython version as the.pyc; otherwisexdis/pydisasm. - Do not execute recovered code on the analysis host;
disis read-only,execis not. - Frida injects GumJS, not Python. Host API:
attach/spawn/create_script. - Entropy flags packing: high-entropy blobs are compressed/encrypted until proven otherwise.
Outcome expectations
- File type, arch, and layout (sections, entry, imports) are known.
- Suspicious APIs and high-entropy regions are listed with offsets.
.pycpayloads are disassembled with a version-matched tool; decompile is opportunistic.- Frida hooks attach (or spawn) without using removed Frida 16 static
Module.*APIs.
Recommended workflow
- Triage: ELF / PE / Mach-O /
.pyc/ PyInstaller overlay. Packed Python →references/pyc-bytecode.mdfirst. - Headers: parse ELF/PE (or LIEF when you will rewrite). Load
references/binary-formats.md. - Sections / imports / strings / entropy:
references/static-analysis.md,references/pwntools-reference.md. - Disassemble hotspots:
references/capstone.md(Capstone) orELF.disasm(returns a string). - Runtime: Frida when static is insufficient —
references/frida-basics.md. Spawn if the interesting path is before a stable attach. - Custom scripts: IAT dump, entropy map, section diff —
references/custom-tooling.md.
Pyarmor, custom opcode maps, and Nuitka-as-native: keep the Python-API path here; load reversing-technique languages.md for those packer-specific recoveries.
Quick review checklist
- Magic/arch parsed; file offsets vs VAs are not mixed.
- Imports enumerated; ordinal-only PE imports are not assumed to have names.
- Strings and entropy scanned before wide disassembly.
.pycmagic matches the interpreter (orpydisasmwas used).- Frida scripts use
Process.getModuleByName/Module.getGlobalExportByName(Frida 17+).
Anti-patterns
- Blind Capstone over the whole file (alignment, data-in-code, packing).
marshal.loadsof a.pycincluding the 16-byte header, or on the wrong Python version.- Treating
uncompyle6as valid past 3.8, orpycdcas guaranteed on 3.13–3.14. Module.findExportByName/ staticModule.getExportByName(removed in Frida 17).Interceptor.replacewithonEnter/onLeave(that isattach; replace takes aNativeCallback).
Resources
Load on demand:
references/binary-formats.md— load when parsing or patching ELF/PE/Mach-O headers and sectionsreferences/pwntools-reference.md— load when usingELF,search,read,disasm,context.binaryreferences/static-analysis.md— load for strings, imports, entropy, suspicious APIsreferences/capstone.md— load when decoding instructions or scanning gadgetsreferences/frida-basics.md— load when attaching/spawning and hooking (Frida 17+ JS API)references/pyc-bytecode.md— load for.pyc,marshal/dis, xdis, PyInstaller unpackreferences/custom-tooling.md— load when writing a reusable IAT/entropy/diff script
Files in this version
references/727.1 KB
- binary-formats.md4.1 KB
- capstone.md3.5 KB
- custom-tooling.md5.5 KB
- frida-basics.md3.0 KB
- pwntools-reference.md3.2 KB
- pyc-bytecode.md3.6 KB
- static-analysis.md4.3 KB
- SKILL.md4.4 KB
Permissions
| Permission | Declared | Found by the scan |
|---|---|---|
| Reads files | Yes | Yes |
| Writes files | Yes | Yes |
| Runs shell commands | Yes | Yes |
| Uses the network | Yes | Yes |
| Uses connectors | No | No |
| Drives a browser | No | No |
Scan findings
Reviewed on Nov 13, 2026
- InfoLink · Links to outside domains
A clean scan lowers the risk but does not prove a package is safe. Read what you install.
| Version | Published | Commit | SHA-256 | Signature | Permission change |
|---|---|---|---|---|---|
| v2026.11.13-21cd568 | Nov 13, 2026 | 21cd568 | 0dee733e | Signed | – |
More from AeonDave
All from this publisherMore in Reverse engineering and fuzzing
See the categoryAsk anything your scope allows.
Create an account, add credits and ask the first question in the chat or the terminal.
- 1/3
Create the account
Individual or company. You can switch to a company later without losing balance or keys.
IndividualCompany - 2/3
Add credits
By card. Pay per token, no subscription.
$5.00minimum deposit - 3/3
Ask
In the chat, or install the CLI and run notholy login in your terminal.
$ notholy login