Ross ROSS = Recommend OSS · open-source software intelligence for agents

decalage2/ViperMonkey

A VBA parser and emulation engine to analyze malicious macros. observed · 2026-08-28

github.com/decalage2/ViperMonkey · Python 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

Full methodology

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

Member repositories

RepositoryRoleHealth v2
decalage2/ViperMonkeymain32

For agents

markdown · JSON · MCP: product_card(name="decalage2/ViperMonkey")

Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem