https://github.com/angr/angr
A powerful and user-friendly binary analysis platform!
https://github.com/angr/angr
analysis angr binary
Last synced: 29 days ago
JSON representation
A powerful and user-friendly binary analysis platform!
- Host: GitHub
- URL: https://github.com/angr/angr
- Owner: angr
- License: bsd-2-clause
- Created: 2015-08-06T21:46:55.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2026-10-16T07:07:13.000Z (about 1 month ago)
- Last Synced: 2026-10-16T07:11:07.796Z (about 1 month ago)
- Topics: analysis, angr, binary
- Language: Python
- Homepage: http://angr.io
- Size: 88.5 MB
- Stars: 9,189
- Watchers: 175
- Forks: 1,202
- Open Issues: 763
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
- Copyright: COPYRIGHT
Awesome Lists containing this project
- Awesome-Security-Tool-List - Angr
- awesome-malware-analysis - angr - Platform-agnostic binary analysis (Debugging and Reverse Engineering / Other Resources)
- awesome-embedded-fuzzing - angr
- awesome-reverse-engineering - angr - Python framework for symbolic execution and program analysis; [angr-management](https://github.com/angr/angr-management) is its official GUI front end, not a separate analysis engine. (Diffing and analysis frameworks / Books)
- awesome-executable-packing - Angr - Platform-agnostic binary analysis framework. (:wrench: Tools / Before 2000)
- awesome-computer-science - code - [angr](https://github.com/angr/angr) - 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. (Reverse Engine)
- static-analysis - angr - Binary code analysis tool that also supports symbolic execution. (Other)
- awesome-rea - angr - Python binary-analysis framework combining control-flow recovery, symbolic execution, data-flow analysis and decompilation. <sub>Tool · Library · [Full entry](https://awesomerea.org/resources/angr/)</sub> (Resources / Native Binary)
- fucking-awesome-malware-analysis - angr - Platform-agnostic binary analysis (Debugging and Reverse Engineering / Other Resources)
- fucking-static-analysis - angr
- awesome-connected-things-sec - Angr - Binary Analysis
- awesome-guidelines - angr
- dynamic-analysis - angr
- awesome-reverse-engineering - **3960**星 - friendly binary analysis platform! (<a id="1d9dec1320a5d774dc8e0e7604edfcd3"></a>工具-新添加的 / <a id="8f1b9c5c2737493524809684b934d49a"></a>文章&&视频)
- awesome-reversing - angr
- awesome-reverse-engineering - angr - 2026-11 · ★ 9.4k (🧮 Analysis Frameworks & Libraries)
- awesome-ctf - Angr - platform-agnostic binary analysis framework. (Reversing)
- awesome-ctf - Angr - platform-agnostic binary analysis framework. (Reversing)
- awesome-ctf-resources - Angr - A powerful and user-friendly binary analysis platform. (Reversing)
- awesome-repositories - angr / angr
- github-ultimate-repos - angr/angr - | ⭐ 9,237★ | 🍴 1,207 | 💻 `Python`🔗 <https://github.com/angr/angr>📝 A powerful and user-friendly binary analysis platform\!⚙️ `CPython C-API binding -> vectorized NumPy ndarray broadcasting -> SIMD/BLAS numerical linear algebra -> computational pipeline execution -> serialized analytical output.` (📜 Master Categorized Repository Directory (100% Clickable Links) / [55] PYTHON ECOSYSTEM, DATA SCIENCE, SCIENTIFIC COMPUTING & ANALYTICS)
- awesome-embedded-security - Angr - Platform-agnostic binary analysis framework. 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. (Software Tools / Disassemblers/Decompilers)
- awesome-ctf - Angr - platform-agnostic binary analysis framework. (Reversing)
README
# angr
[](https://pypi.python.org/pypi/angr/)
[](https://pypi.python.org/pypi/angr/)
[](https://pypistats.org/packages/angr)
[](https://github.com/angr/angr/blob/master/LICENSE)
angr is a platform-agnostic binary analysis framework.
It is brought to you by [the Computer Security Lab at UC Santa Barbara](https://seclab.cs.ucsb.edu), [SEFCOM at Arizona State University](https://sefcom.asu.edu), their associated CTF team, [Shellphish](https://shellphish.net), the open source community, and **[@rhelmot](https://github.com/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](https://docs.angr.io/core-concepts/toplevel) 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.
```python
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
- [Install Instructions](https://docs.angr.io/introductory-errata/install)
- Documentation as [HTML](https://docs.angr.io/) and sources in the angr [Github repository](https://github.com/angr/angr/tree/master/docs)
- Dive right in: [top-level-accessible methods](https://docs.angr.io/core-concepts/toplevel)
- [Examples using angr to solve CTF challenges](https://docs.angr.io/examples).
- [API Reference](https://docs.angr.io/en/latest/api.html)
- [awesome-angr repo](https://github.com/degrigis/awesome-angr)