Installation

Prerequisites

angr Management requires:

Python: Version 3.10 or higher
Operating System: Windows, macOS, or Linux
Display: Graphical environment (X11, Wayland, or native)

Pre-built Windows executables are currently unsigned. You may need to bypass SmartScreen warnings when running for the first time.

Installation Methods

Choose the installation method that best fits your needs:

Portable Executable
PyPI (pip)
uv Package Manager
Development Install

Pre-built Executable (Recommended for Quick Start)

The easiest way to run angr Management is using a portable, pre-built executable:

Download

Get the latest release from the GitHub Releases pageChoose the appropriate build for your platform:

Windows: angr-management-win64.zip
macOS: angr-management-macos.zip
Linux: angr-management-linux.tar.gz

Extract

Extract the downloaded archive to any location:

Linux/macOS

tar -xzf angr-management-linux.tar.gz
cd angr-management

Windows

Expand-Archive angr-management-win64.zip
cd angr-management-win64

Run

Launch the executable directly:

Linux/macOS

./angr-management

Windows

.\angr-management.exe

Portable builds can run from any location without installation. They include all dependencies bundled.

Install from PyPI

Install angr Management using pip for system-wide or virtual environment installation:

Create Virtual Environment (Recommended)

python -m venv angr-env
source angr-env/bin/activate  # On Windows: angr-env\Scripts\activate

Install via pip

pip install angr-management

This will install angr Management and all its dependencies:

angr[angrDB] - The angr binary analysis framework
PySide6-Essentials - Qt6 GUI framework
cle - Binary loader
binsync - Collaboration support
And more…

Verify Installation

angr-management --version

Expected output:

angr-management 9.2.205.dev0

Running After Installation

Once installed, you can launch angr Management using either command:

angr-management
# or the shorter alias
am

The am command is a convenient shortcut defined in the package’s entry points.

Install with uv

If you’re using the modern uv package manager, you can install angr Management as a tool:

uv tool install angr-management

This creates an isolated environment and makes the angr-management and am commands available globally.

Running

angr-management
# or
am

Benefits of uv

Faster installation times
Better dependency resolution
Isolated tool environments
No need to manage virtual environments manually

Development Installation

For contributing to angr Management or using the latest development version:

Clone angr-dev

The recommended way is using angr-dev:

git clone https://github.com/angr/angr-dev
cd angr-dev

Run Setup Script

Linux/macOS

./setup.sh

Windows

.\setup.bat

This sets up the entire angr suite including angr Management in the angr-management directory.

Install FLIRT Signatures (Optional)

For function signature detection:

cd angr-management
git clone --recurse-submodules https://github.com/angr/angr-management

This clones the flirt_signatures submodule.

Run from Source

cd angr-management
python start.py
# or
angr-management

If you encounter dependency issues after updating, re-run the setup script to ensure all dependencies are current.

Development Dependencies

Install additional development tools:

pip install -e .[dev]

This includes:

Testing tools (pytest, coverage)
Documentation tools (Sphinx, furo)
PyInstaller for building executables

Configuration

After installation, angr Management stores configuration files in platform-specific locations:

~/.config/angr-management/config.toml

The configuration file is automatically created on first run with default settings.

Optional Components

BinTrace Support

For advanced dynamic tracing capabilities:

pip install angr-management[bintrace]

Platform-Specific Dependencies

Some features require platform-specific packages:

macOS
Linux (non-ARM)

pip install pyobjc-framework-Cocoa

Required for proper macOS integration (automatically installed on macOS).

pip install keystone-engine

Used for assembly code generation in patches.

Troubleshooting

Qt Platform Plugin Error

If you see Could not load the Qt platform plugin:

# Install Qt dependencies on Linux
sudo apt-get install libxcb-xinerama0 libxcb-cursor0

# Or on Fedora/RHEL
sudo dnf install xcb-util-cursor

Import Errors After Installation

Ensure you’re using Python 3.10 or higher:

python --version

If using a virtual environment, make sure it’s activated.

PySide6 Version Conflicts

angr Management requires PySide6 >= 6.4.2 and excludes version 6.7.0:

pip install "PySide6-Essentials>=6.4.2,!=6.7.0" --force-reinstall

Performance Issues

For better performance with large binaries:

Increase available memory
Consider using the pre-built executable (optimized builds)
Enable selective analysis instead of full binary analysis

Verifying Installation

Test your installation by running:

# Check version
angr-management --version

# View help
angr-management --help

# Launch GUI
angr-management

If the GUI launches successfully, your installation is complete!

Next Steps

Quickstart Guide

Learn how to load and analyze your first binary

Configuration

Customize angr Management to your preferences

Get Started

User Guide

Features

Prerequisites

Installation Methods

Pre-built Executable (Recommended for Quick Start)

Install from PyPI

Running After Installation

Install with uv

Running

Benefits of uv

Development Installation

Development Dependencies

Configuration

Optional Components

BinTrace Support

Platform-Specific Dependencies

Troubleshooting

Verifying Installation

Next Steps

Quickstart Guide

Configuration

Build docs developers (and LLMs) love

Get Started

User Guide

Features

​Prerequisites

​Installation Methods

​Pre-built Executable (Recommended for Quick Start)

​Install from PyPI

​Running After Installation

​Install with uv

​Running

​Benefits of uv

​Development Installation

​Development Dependencies

​Configuration

​Optional Components

​BinTrace Support

​Platform-Specific Dependencies

​Troubleshooting

​Verifying Installation

​Next Steps

Quickstart Guide

Configuration

Build docs developers (and LLMs) love

Prerequisites

Installation Methods

Pre-built Executable (Recommended for Quick Start)

Install from PyPI

Running After Installation

Install with uv

Running

Benefits of uv

Development Installation

Development Dependencies

Configuration

Optional Components

BinTrace Support

Platform-Specific Dependencies

Troubleshooting

Verifying Installation

Next Steps