Install from PyPI
Install OFRAK quickly using pip for the simplest setup.
Prerequisites
- Python 3.9+ and pip
- cmake and libmagic (macOS only - install via
brew install cmake libmagic
)
Quick Install
Use virtual environment
We strongly recommend installing OFRAK using a Python virtual environment. For example, to use venv:
$ python3 -m venv venv
$ source venv/bin/activate
pip install ofrak
Verify Installation
Activate an OFRAK License. For example, to use the OFRAK Community License:
$ ofrak license --community --i-agree
See ofrak license --help
for more license options.
Once the license is installed, this command will list all installed OFRAK modules and components:
ofrak list
Installing Disassembler Backend
angr + Capstone (Recommended for beginners)
pip install ofrak_angr ofrak_capstone
These work together: angr identifies functions, capstone disassembles code.
Ghidra
pip install ofrak_ghidra
Requires Ghidra installed separately. See Ghidra Backend Guide.
Binary Ninja
pip install ofrak_binary_ninja
Requires Binary Ninja license. See Binary Ninja Backend Guide.
Common Issues
Python Version Errors
Symptoms: Import errors, package installation failures.
Solution: Use Python 3.9+ for full compatibility:
python3.9 -m pip install ofrak
Missing System Dependencies
Symptoms: Runtime errors about missing tools (e.g., "pigz not found").
Solution: Use ofrak deps
to identify and install (see above).
Permission Errors
Solution: Use virtual environment or --user
flag:
pip install --user ofrak