Skip to main content

​
Installing angrop

angrop is distributed as a Python package and can be installed via pip. It requires Python 3.6 or higher.

​
Requirements

Python Version: angrop requires Python >= 3.6
angrop has two main dependencies:
  • angr - The symbolic execution engine that powers angrop
  • tqdm - For progress bars during gadget finding
These dependencies will be installed automatically when you install angrop.

​
Installation Steps

1

Ensure Python 3.6+

Verify you have Python 3.6 or higher installed:
python --version
# or
python3 --version
You should see Python 3.6.0 or higher.
2

Install angrop via pip

Install angrop using pip:
pip install angrop
This will install angrop along with all required dependencies including angr and tqdm.
3

Verify installation

Verify the installation by checking the CLI tool:
angrop-cli --help
And verify the Python API:
python -c "import angr, angrop; print('angrop version:', angrop.__version__)"

​
Alternative Installation Methods

​
From Source

If you want to install from source or contribute to development: 
git clone https://github.com/angr/angrop.git
cd angrop
pip install -e .
This installs angrop in editable mode, so changes to the source code are immediately reflected.

​
Using Docker

angrop includes a Dockerfile for containerized usage: 
git clone https://github.com/angr/angrop.git
cd angrop
docker build -t angrop .
docker run -it angrop

​
Troubleshooting

angr has some complex dependencies. If you encounter issues:
  1. Ensure you have a working C compiler installed
  2. Try installing in a fresh virtual environment: 
    python -m venv angrop-env
source angrop-env/bin/activate  # On Windows: angrop-env\Scripts\activate
pip install angrop
  3. Check the angr installation documentation for platform-specific issues
If angrop-cli is not found after installation:
  1. Ensure pip’s bin directory is in your PATH
  2. Try running with python -m angrop.angrop_cli instead
  3. Check if it’s installed with: pip show angrop
If you get import errors:
import sys
print(sys.version)  # Verify Python version >= 3.6
print(sys.path)     # Check if angrop is in the path
Make sure you’re using the same Python environment where you installed angrop.

​
Updating angrop

To update to the latest version: 
pip install --upgrade angrop

​
Uninstalling

To remove angrop: 
pip uninstall angrop
This won’t remove angr and other dependencies. To remove those as well, uninstall them separately or delete the virtual environment.

​
Next Steps

Now that you have angrop installed, head over to the Quickstart guide to build your first ROP chain!

Build docs developers (and LLMs) love

Get started for freeTalk to us