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:
Newer release available (9.3.2)

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.1.post1.tar.gz (2.3 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.1.post1-cp312-abi3-win_amd64.whl (6.7 MB view details)

Uploaded CPython 3.12+Windows x86-64

angr-9.3.1.post1-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.1.post1-cp312-abi3-musllinux_1_2_aarch64.whl (8.2 MB view details)

Uploaded CPython 3.12+musllinux: musl 1.2+ ARM64

angr-9.3.1.post1-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.1.post1-cp312-abi3-manylinux_2_28_aarch64.whl (7.2 MB view details)

Uploaded CPython 3.12+manylinux: glibc 2.28+ ARM64

angr-9.3.1.post1-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.1.post1.tar.gz.

File metadata

  • Download URL: angr-9.3.1.post1.tar.gz
  • Upload date:
  • Size: 2.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for angr-9.3.1.post1.tar.gz
Algorithm Hash digest
SHA256 ed695e58e1866e49ed1e7e015e1d40ac708cb0cd69856bed130dd403f8c0b04b
MD5 6330d2e7e141be2f302fa3a5b861ea81
BLAKE2b-256 59901e99e7184ee84e995c2247fa93cc86d9b5619e342e1a8a96d0ecad035863

See more details on using hashes here.

Provenance

The following attestation bundles were made for angr-9.3.1.post1.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.1.post1-cp312-abi3-win_amd64.whl.

File metadata

  • Download URL: angr-9.3.1.post1-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/6.1.0 CPython/3.13.14

File hashes

Hashes for angr-9.3.1.post1-cp312-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 f556dc1927cdd18cca782debc4cd41485a5d8d3e16a02afd1ef32eb1baf856c2
MD5 91b0b5127e27b81340278a90506872cd
BLAKE2b-256 70eadae8935b5680a42a5c59f17fdd35276c09e4fbd903380061473dfe1c75d5

See more details on using hashes here.

Provenance

The following attestation bundles were made for angr-9.3.1.post1-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.1.post1-cp312-abi3-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for angr-9.3.1.post1-cp312-abi3-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 d2dd730315664cbeb14152aeb64712f72c51ac882cc9fe33d2ee5d20e984c704
MD5 ca1becb6bb0f9843f274b53a81cf1d54
BLAKE2b-256 2022d43438862e73e57c70536ab24179b9f9532e3cab0a48f67a9f849db9fd65

See more details on using hashes here.

Provenance

The following attestation bundles were made for angr-9.3.1.post1-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.1.post1-cp312-abi3-musllinux_1_2_aarch64.whl.

File metadata

File hashes

Hashes for angr-9.3.1.post1-cp312-abi3-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 e9e0bd519ec9d5fd46e16f03e3a4fe0d493310e4ad1999064aea3a06f59586e6
MD5 9388df73d468491c58dfe42ae196f2ea
BLAKE2b-256 051ef39f1f2dc241c46a71266093710064f7192c7b9e58a19152437b2a511986

See more details on using hashes here.

Provenance

The following attestation bundles were made for angr-9.3.1.post1-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.1.post1-cp312-abi3-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for angr-9.3.1.post1-cp312-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 d4a06a9810a1be56a88c4e00b299da2212fcd33d522ca8c9f80ad384bf81efdf
MD5 59f8c094947886a98751b26f094c7d7d
BLAKE2b-256 33322205c29d1c3937a385431f7a5087a3ba71e58560c352cf82f7c9fc0c92a6

See more details on using hashes here.

Provenance

The following attestation bundles were made for angr-9.3.1.post1-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.1.post1-cp312-abi3-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for angr-9.3.1.post1-cp312-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 3ab8d440bc459ac9f40e67d45adec5a4d44a3885891f3801a997d72bf6d2ce60
MD5 e64573dcda6ac401c8bf00c5d80fb92c
BLAKE2b-256 37dca9fff4c6beb498b54404ea418c987d36cfd797137cd5170d81685fe19b6f

See more details on using hashes here.

Provenance

The following attestation bundles were made for angr-9.3.1.post1-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.1.post1-cp312-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for angr-9.3.1.post1-cp312-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 42bfa467b9667fad9433126c2a6e6827ab299e45163a4f36b840e8f6c7fc82b5
MD5 75e05fc9a423659119ff7b28257ecf8a
BLAKE2b-256 dc69c19b66a455db3bcbeac608465a6e416c1257050f8a6d7572a4bad4e557c0

See more details on using hashes here.

Provenance

The following attestation bundles were made for angr-9.3.1.post1-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

9.3.2

This release

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