---
id: vivisect
version: "1.3.2"
license: Apache License 2.0
license_treatment: permissive
maintenance: active
---

# vivisect — Pure python disassembler, debugger, emulator, and static analysis framework

License: permissive · Maintenance: active · Downloads: 96.0K/mo

## What it is and what it does

Vivisect is a comprehensive binary analysis framework written in pure Python that combines disassembly, static analysis, symbolic execution, and debugging into a single toolkit. It reads and analyzes compiled binaries, allowing security researchers and reverse engineers to understand program behavior without source code. The framework includes both programmatic APIs for scripting analysis tasks and a GUI debugger (vdb) for interactive exploration.

The package depends on pyasn1, pyasn1-modules, cxxfilt, msgpack, and pycparser to handle binary formats, name demangling, and data serialization. It targets Python 3.8 and later, with workspaces stored in msgpack format for cross-version compatibility. The project is actively maintained with recent commits and a growing user base, making it suitable for security research, malware analysis, and educational reverse engineering.

Use it for:

- Analyze malware samples to understand their structure, behavior, and capabilities without executing them.
- Perform static analysis on compiled binaries to identify vulnerabilities or suspicious code patterns.
- Debug running processes interactively using the vdb debugger component.
- Automate binary analysis tasks via Python scripts using the framework's programmatic API.
- Learn assembly language and reverse engineering techniques with an interactive disassembler.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Vivisect is a pure-Python disassembler, debugger, emulator, and static analysis framework for binary analysis and reverse engineering.

Yes. Vivisect is actively maintained, has low install friction, carries no known vulnerabilities, and is licensed permissively. It fills a genuine need for pure-Python binary analysis. Install it if you do reverse engineering, malware analysis, or security research; skip it if you need only simple disassembly or prefer established alternatives like IDA Pro or Ghidra.

## Install

pip install vivisect
uv add vivisect
poetry add vivisect

## Installing vivisect

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release; last commit on 2026-08-14 and 136 days since the latest release indicate ongoing development.

License in practice: Licensed under Apache License 2.0 (permissive), allowing commercial and private use with minimal restrictions.

Quickstart:

pip install vivisect

import vivisect
vw = vivisect.VivWorkspace()
vw.loadBinary('path/to/binary')

Requires Python 3.8 or later; Python 2 support ended before v1.0.0. Old Python 2 workspaces are not compatible with Python 3 without conversion.

Verify before relying:

- Whether the GUI components (available via pip install vivisect[gui]) are fully functional and documented.
- Performance characteristics and scalability limits for large binaries or complex analysis tasks.
- Specific symbolic execution capabilities and their scope compared to other frameworks.

## Package facts

- License: Apache License 2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 96.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

binary disassembler python, static analysis framework, symbolic execution debugger, reverse engineering tools, binary analysis framework, python debugger emulator, code analysis disassembly, reverse-engineering, binary-analysis, malware-research

[View on SkillFed](https://skillfed.io/packages/vivisect) · [View on PyPI](https://pypi.org/project/vivisect/)