decalage2/ViperMonkey
A VBA parser and emulation engine to analyze malicious macros. observed · 2026-08-28
Health v2 · maintenance only
32/100
- Activity 0
- Release rhythm 35
- Longevity 100
Flags: no_releases no_license
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.
- gap_med: n/a
- age_days: 3629
- days_rel: n/a
- days_push: 784
- n_releases_24m: 0
Adoption not part of the score
1124 stars · 188 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded
ViperMonkey is a VBA parser and emulation engine written in Python for analyzing and deobfuscating malicious macros in Microsoft Office documents. It emulates VBA code execution to reveal the behavior of maldocs without running them in a live Office environment.
Use cases
- analyze malicious VBA macros in Word documents
- deobfuscate obfuscated Office macros
- extract URLs and payloads from maldocs
- emulate VBA code safely without running Office
- triage suspicious email attachments
- automate macro malware analysis in a sandbox
When to choose
- you need to understand what a malicious Office macro does without executing it
- you want automated, scriptable VBA emulation for malware triage pipelines
- you need to deobfuscate heavily obfuscated VBA strings and logic
When to avoid
- you need fast, real-time scanning of large document volumes
- the macro relies on complex Office application features or DLL/ActiveX calls that emulation does not support
- you need a production-grade, commercially supported analysis tool
Facets
library · maturity maintenance
parser security reverse-engineering interpreter security developer-tools files python windows cli vba macro-analysis malware-analysis emulation maldoc office-files deobfuscation linux macos docker
1 source
- readme: https://github.com/decalage2/ViperMonkey · fetched 2026-08-28 · a67db518e9e7
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| decalage2/ViperMonkey | main | 32 |
For agents
markdown · JSON · MCP: product_card(name="decalage2/ViperMonkey")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem