To install Capstone, you should run pip install capstone.

If you would like to build Capstone with just the source distribution, without pip, just run python setup.py install in the folder with setup.py in it.

In order to use this source distribution, you will need an environment that can compile C code. On Linux, this is usually easy, but on Windows, this involves installing Visual Studio and using the "Developer Command Prompt" to perform the installation. See BUILDING.txt for more information.

By default, attempting to install the python bindings will trigger a build of the capstone native core. If this is undesirable for whatever reason, for instance, you already have a globally installed copy of libcapstone, you may inhibit the build by setting the environment variable LIBCAPSTONE_PATH. The exact value is not checked, just setting it will inhibit the build. During execution, this variable may be set to the path of a directory containing a specific version of libcapstone you would like to use.

If you don't want to build your own copy of Capstone, you can use a precompiled binary distribution from PyPI. Saying pip install capstone should automatically obtain an appropriate copy for your system. If it does not, please open an issue at https://github.com/aquynh/capstone and tag @rhelmot - she will fix this, probably!

Capstone is a disassembly framework with the target of becoming the ultimate disasm engine for binary analysis and reversing in the security community.

Created by Nguyen Anh Quynh, then developed and maintained by a small community, Capstone offers some unparalleled features:

  • Support multiple hardware architectures: ARM, ARM64 (ARMv8), Mips, PPC, Sparc, SystemZ, XCore and X86 (including X86_64).

  • Having clean/simple/lightweight/intuitive architecture-neutral API.

  • Provide details on disassembled instruction (called “decomposer” by others).

  • Provide semantics of the disassembled instruction, such as list of implicit registers read & written.

  • Implemented in pure C language, with lightweight wrappers for C++, C#, Go, Java, NodeJS, Ocaml, Python, Ruby & Vala ready (available in main code, or provided externally by the community).

  • Native support for all popular platforms: Windows, Mac OSX, iOS, Android, Linux, *BSD, Solaris, etc.

  • Thread-safe by design.

  • Special support for embedding into firmware or OS kernel.

  • High performance & suitable for malware analysis (capable of handling various X86 malware tricks).

  • Distributed under the open source BSD license.

Further information is available at http://www.capstone-engine.org

[License]

This project is released under the BSD license. If you redistribute the binary or source code of Capstone, please attach file LICENSE.TXT with your products.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (5.0.9)

4 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for aquynh from gravatar.com aquynh Avatar for kabeor from gravatar.com kabeor Avatar for qilingframework from gravatar.com qilingframework
+1 more Avatar for rhelmot from gravatar.com rhelmot

Credits

Author: Nguyen Anh Quynh

License

BSD License

Requires

Python >=3.8

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

capstone-5.0.2.tar.gz (2.9 MB view details)

Uploaded Source

Built Distributions

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

capstone-5.0.2-py3-none-win_amd64.whl (1.3 MB view details)

Uploaded Python 3Windows x86-64

capstone-5.0.2-py3-none-win32.whl (1.3 MB view details)

Uploaded Python 3Windows x86

capstone-5.0.2-py3-none-musllinux_1_1_aarch64.whl (2.8 MB view details)

Uploaded Python 3musllinux: musl 1.1+ ARM64

capstone-5.0.2-py3-none-manylinux2014_aarch64.whl (2.8 MB view details)

Uploaded Python 3

capstone-5.0.2-py3-none-manylinux1_x86_64.musllinux_1_1_x86_64.whl (2.9 MB view details)

Uploaded Python 3musllinux: musl 1.1+ x86-64

capstone-5.0.2-py3-none-manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.9 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ x86-64

capstone-5.0.2-py3-none-manylinux1_i686.musllinux_1_1_i686.whl (2.9 MB view details)

Uploaded Python 3musllinux: musl 1.1+ i686

capstone-5.0.2-py3-none-manylinux1_i686.manylinux_2_5_i686.manylinux_2_17_i686.manylinux2014_i686.whl (2.9 MB view details)

Uploaded Python 3manylinux: glibc 2.17+ i686manylinux: glibc 2.5+ i686

capstone-5.0.2-py3-none-macosx_11_0_arm64.whl (2.4 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

capstone-5.0.2-py3-none-macosx_10_9_x86_64.whl (2.4 MB view details)

Uploaded Python 3macOS 10.9+ x86-64

capstone-5.0.2-py3-none-macosx_10_9_universal2.whl (2.4 MB view details)

Uploaded Python 3macOS 10.9+ universal2 (ARM64, x86-64)

File details

Details for the file capstone-5.0.2.tar.gz.

File metadata

  • Download URL: capstone-5.0.2.tar.gz
  • Upload date:
  • Size: 2.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for capstone-5.0.2.tar.gz
Algorithm Hash digest
SHA256 2bcebb5746027fbd082b5392c9f56c9f5645bdf11555fff70eedb6ed724f4d5d
MD5 9f94cf51770e2ee73e4f51af325b4980
BLAKE2b-256 97351ed46590e1b64ce656dfd77ed64873fe4aecbfd7dec29038cf183f04ec5b

See more details on using hashes here.

File details

Details for the file capstone-5.0.2-py3-none-win_amd64.whl.

File metadata

  • Download URL: capstone-5.0.2-py3-none-win_amd64.whl
  • Upload date:
  • Size: 1.3 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for capstone-5.0.2-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 fb8391fc58f9fe75e64ce67aeb680d237c0eb50c259b1636fd5580dd85f8d465
MD5 14052e61f221ca6e760be97eded70158
BLAKE2b-256 5634daf758de6087ce166a90794c5a9bbda884c55e00f42d59f7c45ca651e947

See more details on using hashes here.

File details

Details for the file capstone-5.0.2-py3-none-win32.whl.

File metadata

  • Download URL: capstone-5.0.2-py3-none-win32.whl
  • Upload date:
  • Size: 1.3 MB
  • Tags: Python 3, Windows x86
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for capstone-5.0.2-py3-none-win32.whl
Algorithm Hash digest
SHA256 6c2074a3c2e11aceac87499b92ad043fddfef0f79221aa47b07be074021bf413
MD5 cdee12c03cd22a2fac8dc855fdd330f3
BLAKE2b-256 995ad6dba877466f78f1cb6894ea5d8db8eadcb97ba63949606efd5848b686da

See more details on using hashes here.

File details

Details for the file capstone-5.0.2-py3-none-musllinux_1_1_aarch64.whl.

File metadata

File hashes

Hashes for capstone-5.0.2-py3-none-musllinux_1_1_aarch64.whl
Algorithm Hash digest
SHA256 5e6bc5e3bfeeb84fa5a0c3bbeb295a4011626a3ea64e0c8e7a47bd3fbd9310b1
MD5 97cf5ac8620c6683cddb17259c1886d3
BLAKE2b-256 d9989fecc2299e8a3d8a258db5d4363b6364ba1fc7d24499938a8f4f242623fa

See more details on using hashes here.

File details

Details for the file capstone-5.0.2-py3-none-manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for capstone-5.0.2-py3-none-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 80abdd5091662e58b0b2afefbcbb76a01f83c46ad53a51e3ce4737824714242b
MD5 7ae8a9377f6ffd882d503b3b6575c4d0
BLAKE2b-256 c7462f659c0791d2eeaa32445157bb092aac61d144ba2f119eb3e1d82e381de1

See more details on using hashes here.

File details

Details for the file capstone-5.0.2-py3-none-manylinux1_x86_64.musllinux_1_1_x86_64.whl.

File metadata

File hashes

Hashes for capstone-5.0.2-py3-none-manylinux1_x86_64.musllinux_1_1_x86_64.whl
Algorithm Hash digest
SHA256 3c4720e7be3e569d3a48cf36fc37dee4dcce4dbad70077d74c4e8e72aba34d05
MD5 8dc2a98850f010df053b9cd4f599b869
BLAKE2b-256 9273f1e47925572071ef1050dddc3e824a74d9986820449622f7de84651d1771

See more details on using hashes here.

File details

Details for the file capstone-5.0.2-py3-none-manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for capstone-5.0.2-py3-none-manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 7edc160b8363d61e2ab14505ae9ce5e39529eee4b91c4558b170446f724ef4a1
MD5 1a6724132098a8b48c0e7d71766ba2d9
BLAKE2b-256 13223521abe24300533b8139c04e402334d0f9f60cf760ab6f218897a787a7bc

See more details on using hashes here.

File details

Details for the file capstone-5.0.2-py3-none-manylinux1_i686.musllinux_1_1_i686.whl.

File metadata

File hashes

Hashes for capstone-5.0.2-py3-none-manylinux1_i686.musllinux_1_1_i686.whl
Algorithm Hash digest
SHA256 9151c03c105ee5ded4cdcc2080eb0da8eb822ed27ffc79d2113226c299aa7697
MD5 4ffd3b6201ebf40b13d16ef52ce4dfb9
BLAKE2b-256 1632556818ddc901f89085cef392775c97e0d3d5ea44138436f66a22c24fa48f

See more details on using hashes here.

File details

Details for the file capstone-5.0.2-py3-none-manylinux1_i686.manylinux_2_5_i686.manylinux_2_17_i686.manylinux2014_i686.whl.

File metadata

File hashes

Hashes for capstone-5.0.2-py3-none-manylinux1_i686.manylinux_2_5_i686.manylinux_2_17_i686.manylinux2014_i686.whl
Algorithm Hash digest
SHA256 f694cabe9a874e214ffec4c8ac3bd01926301cf2de829b857d1a9230759ccede
MD5 3b26997ce2f0ca8066c70d17bb9edf4c
BLAKE2b-256 f40f13b00d8c07035cd830de8f53b8404254de0839375a01e209cc273428a0c0

See more details on using hashes here.

File details

Details for the file capstone-5.0.2-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for capstone-5.0.2-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 d2ba67d6ab5bdd64486614915ffad5df02571093deb0dff20d5d47db32a7c467
MD5 643d0c0298d6e344da066d34ca245c52
BLAKE2b-256 f4402f02f5b41a0b237dea60806b4e1b5d21c68ece98eb1ee43624bebb0c496d

See more details on using hashes here.

File details

Details for the file capstone-5.0.2-py3-none-macosx_10_9_x86_64.whl.

File metadata

File hashes

Hashes for capstone-5.0.2-py3-none-macosx_10_9_x86_64.whl
Algorithm Hash digest
SHA256 4ac27de0f5ba3adcfb95a1a5a0c4964aa3d2fb1c3da924ef6bc0b3533ede7367
MD5 01d7096f8b1d0207e281fe36e4fb8a43
BLAKE2b-256 727c6556e531846de1e972384d98e3c88f0090a6021a553a0436e0898deb5375

See more details on using hashes here.

File details

Details for the file capstone-5.0.2-py3-none-macosx_10_9_universal2.whl.

File metadata

File hashes

Hashes for capstone-5.0.2-py3-none-macosx_10_9_universal2.whl
Algorithm Hash digest
SHA256 d4148c094e33e19d0bc98e1b161143722ddd1ff5d4994a09f871d3fa22f4ef89
MD5 17c286dfbb2584112c7cc75a3222c2b5
BLAKE2b-256 48371c5233802b3d31733ad68ed3cf639419952ae55a5a1f7789a1c45fec5421

See more details on using hashes here.

Release history Release notifications | RSS feed

Pre-release

6.0.0a10

23 files

Pre-release

6.0.0a9

23 files

Pre-release

6.0.0a8

23 files

Pre-release

6.0.0a7

23 files

Pre-release

6.0.0a6

17 files

Pre-release

6.0.0a5

9 files

Pre-release

6.0.0a4

53 files

Pre-release

6.0.0a3

41 files

Pre-release

6.0.0a2

41 files

Pre-release

6.0.0a1

11 files

5.0.9

11 files

5.0.8

11 files

5.0.7

11 files

5.0.6

11 files

5.0.5

11 files

5.0.4

11 files

5.0.3

11 files

This release

5.0.2 This release

12 files

5.0.1

8 files

5.0.0.post1

8 files

Yanked

5.0.0

9 files

Yanked reason: wrong

Pre-release

5.0.0rc4

8 files

Pre-release

5.0.0rc2

9 files

4.0.2

5 files

4.0.1

5 files

4.0.0

5 files

3.0.5.post1

5 files

3.0.5

5 files

Pre-release

3.0.5rc2

5 files

3.0.4

1 file

3.0.3

1 file

3.0.2

1 file

3.0.1

1 file

3.0

1 file

2.1

1 file

2.0

1 file

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