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.

Project Links

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

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

6 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for angr-bot from gravatar.com angr-bot Avatar for kphoenix from gravatar.com kphoenix Avatar for ltfish from gravatar.com ltfish
+3 more Avatar for rhelmot from gravatar.com rhelmot Avatar for salls from gravatar.com salls Avatar for zardus from gravatar.com zardus

License expression

BSD-2-Clause
View SPDX License List

Requires

Python >=3.12

Provides Extra

angrdb keystone telemetry llm unicorn

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

angr-9.3.2.tar.gz (2.4 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

angr-9.3.2-cp312-abi3-win_amd64.whl (6.7 MB view details)

Uploaded CPython 3.12+Windows x86-64

angr-9.3.2-cp312-abi3-musllinux_1_2_x86_64.whl (8.8 MB view details)

Uploaded CPython 3.12+musllinux: musl 1.2+ x86-64

angr-9.3.2-cp312-abi3-musllinux_1_2_aarch64.whl (8.2 MB view details)

Uploaded CPython 3.12+musllinux: musl 1.2+ ARM64

angr-9.3.2-cp312-abi3-manylinux_2_28_x86_64.whl (7.5 MB view details)

Uploaded CPython 3.12+manylinux: glibc 2.28+ x86-64

angr-9.3.2-cp312-abi3-manylinux_2_28_aarch64.whl (7.2 MB view details)

Uploaded CPython 3.12+manylinux: glibc 2.28+ ARM64

angr-9.3.2-cp312-abi3-macosx_11_0_arm64.whl (6.5 MB view details)

Uploaded CPython 3.12+macOS 11.0+ ARM64

File details

Details for the file angr-9.3.2.tar.gz.

File metadata

  • Download URL: angr-9.3.2.tar.gz
  • Upload date:
  • Size: 2.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for angr-9.3.2.tar.gz
Algorithm Hash digest
SHA256 0b4032332a55105daa98620158c9b3edcaefe7f7f862970a56d27dae0658e15f
MD5 76a1e6009da3d6eaae861b9a766f97b8
BLAKE2b-256 c21ff185cc015a24fdde44927f0b1cbabf6a070867a74f12b75dc1d29bb67fa0

See more details on using hashes here.

Provenance

The following attestation bundles were made for angr-9.3.2.tar.gz:

Publisher: angr-release.yml on angr/ci-settings

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file angr-9.3.2-cp312-abi3-win_amd64.whl.

File metadata

  • Download URL: angr-9.3.2-cp312-abi3-win_amd64.whl
  • Upload date:
  • Size: 6.7 MB
  • Tags: CPython 3.12+, Windows x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for angr-9.3.2-cp312-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 eb07c2abf8e0747a3aab6ba7f97f8e323b7c50347929d1023b4114059f4bccc2
MD5 09365e02b6faabb37b93dd1bdfe9e738
BLAKE2b-256 5c1226e9e73c304a769881a5fc147c77dbf3f949f578bd28a5173fe8037f0d57

See more details on using hashes here.

Provenance

The following attestation bundles were made for angr-9.3.2-cp312-abi3-win_amd64.whl:

Publisher: angr-release.yml on angr/ci-settings

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file angr-9.3.2-cp312-abi3-musllinux_1_2_x86_64.whl.

File metadata

  • Download URL: angr-9.3.2-cp312-abi3-musllinux_1_2_x86_64.whl
  • Upload date:
  • Size: 8.8 MB
  • Tags: CPython 3.12+, musllinux: musl 1.2+ x86-64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for angr-9.3.2-cp312-abi3-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 2f85b0e116321f172a05af7352933b817a713c70f9f50265004a9e4aaed019de
MD5 ebfe6b160100c1d6e160e76052feba58
BLAKE2b-256 ee2b73afd262de2067a2c6af6b25c38887e18434b24c5dc1cda9ac321527b490

See more details on using hashes here.

Provenance

The following attestation bundles were made for angr-9.3.2-cp312-abi3-musllinux_1_2_x86_64.whl:

Publisher: angr-release.yml on angr/ci-settings

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file angr-9.3.2-cp312-abi3-musllinux_1_2_aarch64.whl.

File metadata

File hashes

Hashes for angr-9.3.2-cp312-abi3-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 57016adeed18570a710c92fbad040cd1a833bcaf92f237c9333bbfaff73556da
MD5 1e9234e145c4a723623eaddb9f41e964
BLAKE2b-256 84cba506bed9538b4b512b545241301fbb019c2c9c9ca62eb5dd7a53ac441c41

See more details on using hashes here.

Provenance

The following attestation bundles were made for angr-9.3.2-cp312-abi3-musllinux_1_2_aarch64.whl:

Publisher: angr-release.yml on angr/ci-settings

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file angr-9.3.2-cp312-abi3-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for angr-9.3.2-cp312-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 8b3ad4f4548f3a9405f7f5a21e35908c99b3a346440183a7e7f9d73c57e2bce1
MD5 98ca12bbdc4b2876bf66ff0f082ca069
BLAKE2b-256 09391b981068f134c689afa41ad531e59d057b10e14a23c64ceee0770b087596

See more details on using hashes here.

Provenance

The following attestation bundles were made for angr-9.3.2-cp312-abi3-manylinux_2_28_x86_64.whl:

Publisher: angr-release.yml on angr/ci-settings

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file angr-9.3.2-cp312-abi3-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for angr-9.3.2-cp312-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 5811c91cf804ac6e42f0f59718f9d3767bf2922f32a854fd9427251199716f6b
MD5 9b16072cd95739a68f874d439a7ea7be
BLAKE2b-256 c35ebeff50296772c328fd5756edbd21cdcc42c0a8496ba5a25a12d36edfae26

See more details on using hashes here.

Provenance

The following attestation bundles were made for angr-9.3.2-cp312-abi3-manylinux_2_28_aarch64.whl:

Publisher: angr-release.yml on angr/ci-settings

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file angr-9.3.2-cp312-abi3-macosx_11_0_arm64.whl.

File metadata

  • Download URL: angr-9.3.2-cp312-abi3-macosx_11_0_arm64.whl
  • Upload date:
  • Size: 6.5 MB
  • Tags: CPython 3.12+, macOS 11.0+ ARM64
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for angr-9.3.2-cp312-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 fc04075b6f31876b77c0e2d8d1e9c7e49a18dd9f8798a64d898b9737bd97ddfd
MD5 a0234fa5c9943be4a401f844adb0df9c
BLAKE2b-256 b8e53ee0b08b50d0426bacb2baa8301f494c2c5799f689cecf287b7d7cc95f19

See more details on using hashes here.

Provenance

The following attestation bundles were made for angr-9.3.2-cp312-abi3-macosx_11_0_arm64.whl:

Publisher: angr-release.yml on angr/ci-settings

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

9.3.2

9.3.1.post1

9.3.0

9.2.223

9.2.222

9.2.221

9.2.217

9.2.215

9.2.214

9.2.213

9.2.212

9.2.211

9.2.209

9.2.208

9.2.207

9.2.205

9.2.204

9.2.203

9.2.202

9.2.201

9.2.199

9.2.198

9.2.197

9.2.196

9.2.195

9.2.194

9.2.193

9.2.192

9.2.191

9.2.190

9.2.189

9.2.188

9.2.187

9.2.186

9.2.185

9.2.184

9.2.183

9.2.182

9.2.181

9.2.180

9.2.179

9.2.178

9.2.177

9.2.176

9.2.175

9.2.174

9.2.173

9.2.172

9.2.171

9.2.170

9.2.169

9.2.168

9.2.167

9.2.166

9.2.165

9.2.164

9.2.163

9.2.162

9.2.161

9.2.160

9.2.159

9.2.158

9.2.157

9.2.156

9.2.154

9.2.153

9.2.152

9.2.150

9.2.149

9.2.148

9.2.147

9.2.146

9.2.145

9.2.144

9.2.143

9.2.142

9.2.141

9.2.140

9.2.139

9.2.138

9.2.137

9.2.136

9.2.135

9.2.134

9.2.133

9.2.132

9.2.131

9.2.130

9.2.129

9.2.128

9.2.127

9.2.126

9.2.125

9.2.124

9.2.123

9.2.122

9.2.121

9.2.120

9.2.119

9.2.118

9.2.117

9.2.116

9.2.115

9.2.114

9.2.113

9.2.112

9.2.111

9.2.110

9.2.109

9.2.108

9.2.107

9.2.106

9.2.105

9.2.104

9.2.103

9.2.102

9.2.101

9.2.100

9.2.99

9.2.98

9.2.97

9.2.96

9.2.95

9.2.94

9.2.93

9.2.92

9.2.91

9.2.90

9.2.89

9.2.88

9.2.87

9.2.86

9.2.85

9.2.84

9.2.83

9.2.82

9.2.81

9.2.80

9.2.79

9.2.78

9.2.77

9.2.76

9.2.75

9.2.74

9.2.73

9.2.72

9.2.71

9.2.70

9.2.69

9.2.68

9.2.67

9.2.66

9.2.65

9.2.64

9.2.63

9.2.62

9.2.61

9.2.60

9.2.59

9.2.58

9.2.57

9.2.56

9.2.55

9.2.54

9.2.53

9.2.52

9.2.51

9.2.50

9.2.49

9.2.48

9.2.47

9.2.46

9.2.45

9.2.44

9.2.43

9.2.42

9.2.41

9.2.40

9.2.39

9.2.38

9.2.37

9.2.36

9.2.35

9.2.34

9.2.33

9.2.32

9.2.31

9.2.30

9.2.29

9.2.28

9.2.27

9.2.26

9.2.25

9.2.24

9.2.23

9.2.22

9.2.21

9.2.20

9.2.19

9.2.18

9.2.17

9.2.16

9.2.15

9.2.14

9.2.13

9.2.12

9.2.11

9.2.10

9.2.9

9.2.8

9.2.7

9.2.6

9.2.5

9.2.4

9.2.3

9.2.2

9.2.1

9.1.12332

9.1.11752

9.1.11611

9.1.11508

9.1.10913

9.0.10730

9.0.10689

9.0.10651

9.0.10576

9.0.10534

9.0.10409

9.0.10339

9.0.10281

9.0.10159

9.0.10072

9.0.10055

9.0.10010

9.0.9947

9.0.9792

9.0.9684

9.0.9572

9.0.9506

9.0.9438

9.0.9355

9.0.9297

9.0.9166

9.0.9031

9.0.8761

9.0.8021

9.0.7912

9.0.7833

9.0.7491

9.0.7293

9.0.6885

9.0.6852

9.0.6790

9.0.6642

9.0.6588

9.0.6488

9.0.6421

9.0.6281

9.0.6136

9.0.5903

9.0.5811

9.0.5739

9.0.5610

9.0.5609

9.0.5450

9.0.5405

9.0.5376

9.0.5327

9.0.5326

9.0.5171

9.0.5034

9.0.5002

9.0.4940

9.0.4885

9.0.4663

9.0.4495

9.0.4446

9.0.4378

8.20.7.27

8.20.7.6

8.20.6.8

8.20.6.1

8.20.5.27

8.20.1.7

8.19.10.30

8.19.10.29

8.19.7.25

8.19.4.5

8.19.2.4

8.18.10.25

8.18.10.5

7.8.9.26

7.8.8.1

7.8.7.1

7.8.6.23

7.8.6.16

7.8.2.21

7.7.12.16

7.7.9.21

7.7.9.14

7.7.9.8.post1

7.7.9.8

6.7.7.31

6.7.7.27

6.7.6.9

6.7.4.12

6.7.3.26

6.7.1.31

6.7.1.13.post2

6.7.1.13

5.6.12.3

5.6.10.12

5.6.10.7

5.6.10.5

5.6.8.22

4.6.6.29

4.6.6.28

4.6.6.16

4.6.6.15

4.6.6.10

4.6.6.4.post1

4.6.6.4

4.6.5.27.post1

4.6.5.27

4.6.4.28

4.6.3.28

4.6.3.18

4.6.3.15.post1

4.6.3.15

4.6.2.25

4.6.1.30

4.6.1.18

4.6.1.12

4.6.1.4

4.5.12.28

4.5.12.21

4.5.12.12

4.5.11.23

4.5.10.15

4.5.10.14

4.5.9.29

4.5.9.22

4.5.9.14

4.5.9.13.post1

4.5.9.13

4.5.9.9

4.5.9.9b pre-release

0.8.1

0.8.0

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page