Skip to main content

angr

Latest Release Python Version PyPI Statistics License

angr is a platform-agnostic binary analysis framework. It is brought to you by the Computer Security Lab at UC Santa Barbara, SEFCOM at Arizona State University, their associated CTF team, Shellphish, the open source community, and @rhelmot.

Homepage: https://angr.io

Project repository: https://github.com/angr/angr

Documentation: https://docs.angr.io

API Documentation: https://docs.angr.io/en/latest/api.html

What is angr?

angr is a suite of Python 3 libraries that let you load a binary and do a lot of cool things to it:

  • Disassembly and intermediate-representation lifting
  • Program instrumentation
  • Symbolic execution
  • Control-flow analysis
  • Data-dependency analysis
  • Value-set analysis (VSA)
  • Decompilation

The most common angr operation is loading a binary: p = angr.Project('/bin/bash') If you do this in an enhanced REPL like IPython, you can use tab-autocomplete to browse the top-level-accessible methods and their docstrings.

The short version of "how to install angr" is mkvirtualenv --python=$(which python3) angr && python -m pip install angr.

Example

angr does a lot of binary analysis stuff. To get you started, here's a simple example of using symbolic execution to get a flag in a CTF challenge.

import angr

project = angr.Project("angr-doc/examples/defcamp_r100/r100", auto_load_libs=False)


@project.hook(0x400844)
def print_flag(state):
    print("FLAG SHOULD BE:", state.posix.dumps(0))
    project.terminate_execution()


project.execute()

Quick Start

Metadata

Release files for angr 10.0.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for angr 10.0.6
File Size Uploaded Provenance Actions
angr-10.0.6.tar.gz 3.5 MB With provenance Details for angr-10.0.6.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for angr 10.0.6
File Actions
angr-10.0.6-cp312-abi3-win_amd64.whl CPython 3.12 abi3 Windows x86-64 Details for angr-10.0.6-cp312-abi3-win_amd64.whl
angr-10.0.6-cp312-abi3-musllinux_1_2_x86_64.whl CPython 3.12 abi3 Linux musl 1.2+ x86-64 Details for angr-10.0.6-cp312-abi3-musllinux_1_2_x86_64.whl
angr-10.0.6-cp312-abi3-musllinux_1_2_aarch64.whl CPython 3.12 abi3 Linux musl 1.2+ ARM64 Details for angr-10.0.6-cp312-abi3-musllinux_1_2_aarch64.whl
angr-10.0.6-cp312-abi3-manylinux_2_28_x86_64.whl CPython 3.12 abi3 Linux glibc 2.28+ x86-64 Details for angr-10.0.6-cp312-abi3-manylinux_2_28_x86_64.whl
angr-10.0.6-cp312-abi3-manylinux_2_28_aarch64.whl CPython 3.12 abi3 Linux glibc 2.28+ ARM64 Details for angr-10.0.6-cp312-abi3-manylinux_2_28_aarch64.whl
angr-10.0.6-cp312-abi3-macosx_11_0_arm64.whl CPython 3.12 abi3 macOS 11.0+ ARM64 Details for angr-10.0.6-cp312-abi3-macosx_11_0_arm64.whl

Total release size: 61.9 MB

Release files / angr-10.0.6.tar.gz

Download URL angr-10.0.6.tar.gz
Size 3.5 MB
Tags Source
SHA-256 checksum
How to use checksums
74e7b0e14103599a77a46f72bd787bf5ca9e027bbeb78135c2dee6838984fe1e
BLAKE2b-256 checksum
How to use checksums
3f68842baf2f3c9f2a08840af6abd5c2cca7417f5e5ec3d638906a0c61d92cf9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / angr-10.0.6-cp312-abi3-win_amd64.whl

Download URL angr-10.0.6-cp312-abi3-win_amd64.whl
Size 8.9 MB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
065d47823a8ac565143c5477403d7771619035eafae414e3f88c4ec6383991e6
BLAKE2b-256 checksum
How to use checksums
f025804576826d1d28c4b0af2cfb0e7e780a631dc1c65839cafae0b816d99006
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / angr-10.0.6-cp312-abi3-musllinux_1_2_x86_64.whl

Download URL angr-10.0.6-cp312-abi3-musllinux_1_2_x86_64.whl
Size 11.1 MB
Tags CPython 3.12 Linux musl 1.2+ x86-64 abi3
SHA-256 checksum
How to use checksums
f8c6231046653704785c4213f235d3740fe767dc668de14919941e4cf096c79f
BLAKE2b-256 checksum
How to use checksums
b7622c5e14601be2a7bd00b1fe6e0a5ebb2ed53e329c9d3c4931c128b33c990a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / angr-10.0.6-cp312-abi3-musllinux_1_2_aarch64.whl

Download URL angr-10.0.6-cp312-abi3-musllinux_1_2_aarch64.whl
Size 10.4 MB
Tags CPython 3.12 Linux musl 1.2+ ARM64 abi3
SHA-256 checksum
How to use checksums
b6ab066b3f5d9c98b8a259130430ac4ca68c9027716dc4ef3cd4add8b4db5aab
BLAKE2b-256 checksum
How to use checksums
2e71cdc3434d02274745195c7b5421f8a0223d0a3d601106d1fa8078216348a1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / angr-10.0.6-cp312-abi3-manylinux_2_28_x86_64.whl

Download URL angr-10.0.6-cp312-abi3-manylinux_2_28_x86_64.whl
Size 9.7 MB
Tags CPython 3.12 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
b67eba07a40601bc8d7986ed4d5e15594987f8c66be34406a5f62721dff99eab
BLAKE2b-256 checksum
How to use checksums
ba3c07ae8bd933672d040ea8e4188491fc70b7f74023b3d44f6ddc053f656b8d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / angr-10.0.6-cp312-abi3-manylinux_2_28_aarch64.whl

Download URL angr-10.0.6-cp312-abi3-manylinux_2_28_aarch64.whl
Size 9.5 MB
Tags CPython 3.12 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
ad90e6921050b49559deb9929b0882b066530c51b7c771fdc1e04a38f5a1bc36
BLAKE2b-256 checksum
How to use checksums
09a13cd1926d8e6cf5792e303d44ea9c5e83cf1fa8c4bd79023bd6cb960c6008
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Release files / angr-10.0.6-cp312-abi3-macosx_11_0_arm64.whl

Download URL angr-10.0.6-cp312-abi3-macosx_11_0_arm64.whl
Size 8.7 MB
Tags CPython 3.12 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
99683986cd9b4272ac093656d94d0442600d5673a1c3c4809fb0f74d11c2788f
BLAKE2b-256 checksum
How to use checksums
93d3f49a1bcba9316311717a1d2116cbd251ddf4052df1607d9449b30f2adc86
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

Security for angr 10.0.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 7 files in this release have been uploaded with provenance metadata.

Select from 7 files

Attestation for angr-10.0.6.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 10, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

10.0.6 This release

7 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page