angr


Nameangr JSON
Version 9.2.181 PyPI version JSON
download
home_pageNone
SummaryA multi-architecture binary analysis toolkit, with the ability to perform dynamic symbolic execution and various static analyses on binaries
upload_time2025-10-21 18:20:15
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseBSD-2-Clause
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # angr

[![Latest Release](https://img.shields.io/pypi/v/angr.svg)](https://pypi.python.org/pypi/angr/)
[![Python Version](https://img.shields.io/pypi/pyversions/angr)](https://pypi.python.org/pypi/angr/)
[![PyPI Statistics](https://img.shields.io/pypi/dm/angr.svg)](https://pypistats.org/packages/angr)
[![License](https://img.shields.io/github/license/angr/angr.svg)](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)

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "angr",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/55/43/ccc65cadb11cc863653b89646c68a80dff18314fe5e0fe342b01f695d055/angr-9.2.181.tar.gz",
    "platform": null,
    "description": "# angr\n\n[![Latest Release](https://img.shields.io/pypi/v/angr.svg)](https://pypi.python.org/pypi/angr/)\n[![Python Version](https://img.shields.io/pypi/pyversions/angr)](https://pypi.python.org/pypi/angr/)\n[![PyPI Statistics](https://img.shields.io/pypi/dm/angr.svg)](https://pypistats.org/packages/angr)\n[![License](https://img.shields.io/github/license/angr/angr.svg)](https://github.com/angr/angr/blob/master/LICENSE)\n\nangr is a platform-agnostic binary analysis framework.\nIt 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)**.\n\n## Project Links\nHomepage: https://angr.io\n\nProject repository: https://github.com/angr/angr\n\nDocumentation: https://docs.angr.io\n\nAPI Documentation: https://docs.angr.io/en/latest/api.html\n\n## What is angr?\n\nangr is a suite of Python 3 libraries that let you load a binary and do a lot of cool things to it:\n\n- Disassembly and intermediate-representation lifting\n- Program instrumentation\n- Symbolic execution\n- Control-flow analysis\n- Data-dependency analysis\n- Value-set analysis (VSA)\n- Decompilation\n\nThe 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.\n\nThe short version of \"how to install angr\" is `mkvirtualenv --python=$(which python3) angr && python -m pip install angr`.\n\n## Example\n\nangr does a lot of binary analysis stuff.\nTo get you started, here's a simple example of using symbolic execution to get a flag in a CTF challenge.\n\n```python\nimport angr\n\nproject = angr.Project(\"angr-doc/examples/defcamp_r100/r100\", auto_load_libs=False)\n\n@project.hook(0x400844)\ndef print_flag(state):\n    print(\"FLAG SHOULD BE:\", state.posix.dumps(0))\n    project.terminate_execution()\n\nproject.execute()\n```\n\n# Quick Start\n\n- [Install Instructions](https://docs.angr.io/introductory-errata/install)\n- Documentation as [HTML](https://docs.angr.io/) and sources in the angr [Github repository](https://github.com/angr/angr/tree/master/docs)\n- Dive right in: [top-level-accessible methods](https://docs.angr.io/core-concepts/toplevel)\n- [Examples using angr to solve CTF challenges](https://docs.angr.io/examples).\n- [API Reference](https://docs.angr.io/en/latest/api.html)\n- [awesome-angr repo](https://github.com/degrigis/awesome-angr)\n",
    "bugtrack_url": null,
    "license": "BSD-2-Clause",
    "summary": "A multi-architecture binary analysis toolkit, with the ability to perform dynamic symbolic execution and various static analyses on binaries",
    "version": "9.2.181",
    "project_urls": {
        "Homepage": "https://angr.io/",
        "Repository": "https://github.com/angr/angr"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "890028d102806e8108bc45ba38f5940df1d61ebaf499b833830b8fbd6d16581f",
                "md5": "084e851b0031a6a25f06257272737f2e",
                "sha256": "ad6c51362faa29ff295d0682641ac4de27b4fa98920c9b70006e1cd8566f6c22"
            },
            "downloads": -1,
            "filename": "angr-9.2.181-cp310-abi3-macosx_10_12_x86_64.whl",
            "has_sig": false,
            "md5_digest": "084e851b0031a6a25f06257272737f2e",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": ">=3.10",
            "size": 5948709,
            "upload_time": "2025-10-21T18:19:50",
            "upload_time_iso_8601": "2025-10-21T18:19:50.760478Z",
            "url": "https://files.pythonhosted.org/packages/89/00/28d102806e8108bc45ba38f5940df1d61ebaf499b833830b8fbd6d16581f/angr-9.2.181-cp310-abi3-macosx_10_12_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "d89cabd4e70ed17c84d14005c3d7088b19a304ac355cfefd9712dee47d762b94",
                "md5": "27804265804a1fc4e115a2cbb74b997a",
                "sha256": "ddbc40340606163378a7d8faf9af22ee4be7bef8f6b325840c0fe06550bc9e08"
            },
            "downloads": -1,
            "filename": "angr-9.2.181-cp310-abi3-macosx_11_0_arm64.whl",
            "has_sig": false,
            "md5_digest": "27804265804a1fc4e115a2cbb74b997a",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": ">=3.10",
            "size": 5772229,
            "upload_time": "2025-10-21T18:19:53",
            "upload_time_iso_8601": "2025-10-21T18:19:53.568520Z",
            "url": "https://files.pythonhosted.org/packages/d8/9c/abd4e70ed17c84d14005c3d7088b19a304ac355cfefd9712dee47d762b94/angr-9.2.181-cp310-abi3-macosx_11_0_arm64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "6e711fbe950d02ab5391fd29bc74c137b252ff02cdebefc3e160dfc94d33c826",
                "md5": "08f191a56e2ae45dba9ea70402219ce8",
                "sha256": "743009424d6efa0173101daee87c557d46287f8c0b3bd80f8f2e00b8586be8cc"
            },
            "downloads": -1,
            "filename": "angr-9.2.181-cp310-abi3-manylinux_2_28_aarch64.whl",
            "has_sig": false,
            "md5_digest": "08f191a56e2ae45dba9ea70402219ce8",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": ">=3.10",
            "size": 5973855,
            "upload_time": "2025-10-21T18:19:55",
            "upload_time_iso_8601": "2025-10-21T18:19:55.414480Z",
            "url": "https://files.pythonhosted.org/packages/6e/71/1fbe950d02ab5391fd29bc74c137b252ff02cdebefc3e160dfc94d33c826/angr-9.2.181-cp310-abi3-manylinux_2_28_aarch64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "7cd48a7d27fcd9f6ce3cb2d01bf413f01ac5cb25026af50afb7d95b700fc462b",
                "md5": "0e28ebf29f684f33600e07a94c415a7c",
                "sha256": "651f750bb9e01987459c86446e92fdb710588d8e80910ec6bf449b364600e027"
            },
            "downloads": -1,
            "filename": "angr-9.2.181-cp310-abi3-manylinux_2_28_x86_64.whl",
            "has_sig": false,
            "md5_digest": "0e28ebf29f684f33600e07a94c415a7c",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": ">=3.10",
            "size": 6117348,
            "upload_time": "2025-10-21T18:19:56",
            "upload_time_iso_8601": "2025-10-21T18:19:56.970460Z",
            "url": "https://files.pythonhosted.org/packages/7c/d4/8a7d27fcd9f6ce3cb2d01bf413f01ac5cb25026af50afb7d95b700fc462b/angr-9.2.181-cp310-abi3-manylinux_2_28_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "7b1d859910bb51426f9b3dbe9d8589a695c26d7f179806b061908a895cff3c10",
                "md5": "b36b766789eefb41f2446315957c0171",
                "sha256": "16c29ea5997d55840ba8ffcf845502bdf3ec68d9e53fdc0eabacecffa17e916d"
            },
            "downloads": -1,
            "filename": "angr-9.2.181-cp310-abi3-win_amd64.whl",
            "has_sig": false,
            "md5_digest": "b36b766789eefb41f2446315957c0171",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": ">=3.10",
            "size": 5729274,
            "upload_time": "2025-10-21T18:19:58",
            "upload_time_iso_8601": "2025-10-21T18:19:58.763078Z",
            "url": "https://files.pythonhosted.org/packages/7b/1d/859910bb51426f9b3dbe9d8589a695c26d7f179806b061908a895cff3c10/angr-9.2.181-cp310-abi3-win_amd64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "5543ccc65cadb11cc863653b89646c68a80dff18314fe5e0fe342b01f695d055",
                "md5": "c3600fd4438d3f854231a986b0438890",
                "sha256": "01456465535192706d782b7aa2ccc3a40b0d50af44e222eba4aa821d8c4e4464"
            },
            "downloads": -1,
            "filename": "angr-9.2.181.tar.gz",
            "has_sig": false,
            "md5_digest": "c3600fd4438d3f854231a986b0438890",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 3297121,
            "upload_time": "2025-10-21T18:20:15",
            "upload_time_iso_8601": "2025-10-21T18:20:15.470538Z",
            "url": "https://files.pythonhosted.org/packages/55/43/ccc65cadb11cc863653b89646c68a80dff18314fe5e0fe342b01f695d055/angr-9.2.181.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-21 18:20:15",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "angr",
    "github_project": "angr",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "angr"
}
        
Elapsed time: 2.71387s