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.7

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.7
File Size Uploaded Provenance Actions
angr-10.0.7.tar.gz 3.5 MB With provenance Details for angr-10.0.7.tar.gz

Built distributions (wheels)

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

Total release size: 62.0 MB

Release files / angr-10.0.7.tar.gz

Download URL angr-10.0.7.tar.gz
Size 3.5 MB
Tags Source
SHA-256 checksum
How to use checksums
8e63fab54e6e8b8621e1144708c9c89020cc8f44ba4b4bcb8c90fdb1d09b0e2c
BLAKE2b-256 checksum
How to use checksums
e477917b9840f342a91f1c3e70c8d847b06c2901d37afa7e4ef4a4f4431ee15c
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 13, 2026.

Transparency log

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

Download URL angr-10.0.7-cp312-abi3-win_amd64.whl
Size 9.0 MB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
f11c95e09f9c051e6536a6d59f418bb0a38132cb3636fe261879c6898180d84a
BLAKE2b-256 checksum
How to use checksums
d3bb548c735cc8b80252b95e0451410e1d42cdd4a5cd1eb34a951892f26febe7
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 13, 2026.

Transparency log

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

Download URL angr-10.0.7-cp312-abi3-musllinux_1_2_x86_64.whl
Size 11.2 MB
Tags CPython 3.12 Linux musl 1.2+ x86-64 abi3
SHA-256 checksum
How to use checksums
c835361086f5756b617bd57b5a241893a9debc5d410037c3e46ec031adc9a636
BLAKE2b-256 checksum
How to use checksums
9954d704764431dbf9966ce03b1ad7560851e129b2617f56c96fa2cfc4736f88
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 13, 2026.

Transparency log

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

Download URL angr-10.0.7-cp312-abi3-musllinux_1_2_aarch64.whl
Size 10.5 MB
Tags CPython 3.12 Linux musl 1.2+ ARM64 abi3
SHA-256 checksum
How to use checksums
2c4996d44274dcc500274406f848f142305720430c70096ccd62dfed2870aa57
BLAKE2b-256 checksum
How to use checksums
396d3d9c169267ebbd55a3f2ff537202659d920abec211ce06fa2daba8815a81
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 13, 2026.

Transparency log

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

Download URL angr-10.0.7-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
d3c1903eb9c8481ed650aa7d9502e7baeba8bc880e7c9576d2776b4ec0fd5e08
BLAKE2b-256 checksum
How to use checksums
468a74db39306a3d0093aa9533587e53151f0add724052a19ac9a207b6a6d5a3
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 13, 2026.

Transparency log

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

Download URL angr-10.0.7-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
4b95794e51dc48452ca9b2a1f4969410bc32ef44002a615558471c1b6c987d1d
BLAKE2b-256 checksum
How to use checksums
4602ee63578456c2d0f77a48ddf2389993a467a58484f725dfdd31c2ea1fb4e5
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 13, 2026.

Transparency log

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

Download URL angr-10.0.7-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
68b1ed467ceb0b2d3ce6994a832d2b5596ab58973cc93e3d569b6aa2a87d9b00
BLAKE2b-256 checksum
How to use checksums
434c69bf37c6bacec3836b54bfea6d4938188af593d6f8c816af3af16d3171a8
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 13, 2026.

Transparency log

Security for angr 10.0.7

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.7.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 13, 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.7 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