Installation

Install angrop and get ready to build ROP chains

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 installation fails

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

Command not found: angrop-cli

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

Import errors in Python

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!