hbctool-cli

hbctool logo

A Hermes bytecode disassembler and assembler for React Native bundles.
Originally created by baba01hacker666 and continued by Doraemon cyber team.

Why hbctool

React Native apps can ship JavaScript through the Hermes engine, which compiles application code into Hermes bytecode. That makes reverse engineering, inspection, and patching harder than working with plain JavaScript bundles.

hbctool helps with that workflow by letting you:

disassemble a Hermes bundle into a readable HASM representation
modify metadata, strings, and instructions
rebuild a valid Hermes bytecode bundle from the edited output
use either the pure-Python path or the optional native C++ acceleration path

Features

Disassemble Hermes bytecode bundles into a directory with metadata, strings, and instructions.
Assemble edited HASM output back into a Hermes bundle.
Optional C++ acceleration for faster low-level operations.
Test coverage for pure-Python and native execution paths.
Support for Hermes bytecode versions 59, 62, 74, 76, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92, 93, 94, 95, 96, 97, 98, and 100.

Installation

Quick install

python3 -m pip install hbctool-cli

Local development install

python3 -m pip install --upgrade pip setuptools wheel
python3 -m pip install -e .

PIPX INSTALL

pipx install git+https://github.com/Baba01hacker666/HBC-Tool.git

Build the optional native extension

python3 setup.py build_ext --inplace

Enable the accelerated path at runtime:

export HBCTOOL_FASTUTIL=1

Verify that the native modules are available:

python3 -c "import hbctool._fastutil, hbctool._bitcodec; print('native extensions ok')"

If the extensions are not present, hbctool still works in pure-Python mode.

Usage

Show help:

hbctool --help

CLI syntax:

Usage:
    hbctool disasm <HBC_FILE> [<HASM_PATH>]
    hbctool asm [<HASM_PATH>] [<HBC_FILE>]
    hbctool --help
    hbctool --version

Examples:

hbctool disasm index.android.bundle test_hasm
hbctool asm test_hasm index.android.bundle
hbctool disasm index.android.bundle
hbctool asm

By default:

disasm writes to hasm/
asm reads from hasm/ and writes index.android.bundle

For Android targets, the Hermes bundle is commonly found under the app assets/ directory as index.android.bundle.

Output Layout

A disassembly writes three files:

metadata.json
string.json
instruction.hasm

This makes it practical to inspect strings, metadata, and instructions separately before rebuilding.

Benchmarking

You can benchmark the round-trip path and compare pure Python against the native path with the helper script:

python3 scripts/benchmark_roundtrip.py Testfiles/index.android.bundle --iterations 2 --max-size-ratio 1.10 --min-core-speedup 2.0 --json output/bench/report.json

The report includes:

timing for both execution modes
computed speedup
output-to-input size ratio checks
a low-level memcpy speedup check

The script exits non-zero when configured safety or performance thresholds are not met, which makes it suitable for CI gating.

Development

Run the test suite:

python3 -m pytest -q

Run the test suite with the native path enabled:

HBCTOOL_FASTUTIL=1 python3 -m pytest -q

Build distributable artifacts:

python3 -m pip install --upgrade build
python3 -m build

If the built wheel includes the compiled extension, it will be platform-tagged rather than py3-none-any.

Credits

Created and maintained by baba01hacker666

License

This project is released under the MIT License. See LICENSE.

Download files

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

Source Distribution

hbctool_cli-0.18.tar.gz (471.5 kB view details)

Uploaded Jul 29, 2026 Source

Built Distributions

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

hbctool_cli-0.18-cp313-cp313-win_amd64.whl (524.6 kB view details)

Uploaded Jul 29, 2026 CPython 3.13Windows x86-64

hbctool_cli-0.18-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (583.5 kB view details)

Uploaded Jul 29, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64

hbctool_cli-0.18-cp313-cp313-macosx_11_0_arm64.whl (524.0 kB view details)

Uploaded Jul 29, 2026 CPython 3.13macOS 11.0+ ARM64

hbctool_cli-0.18-cp313-cp313-macosx_10_13_x86_64.whl (523.3 kB view details)

Uploaded Jul 29, 2026 CPython 3.13macOS 10.13+ x86-64

hbctool_cli-0.18-cp312-cp312-win_amd64.whl (524.6 kB view details)

Uploaded Jul 29, 2026 CPython 3.12Windows x86-64

hbctool_cli-0.18-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (583.8 kB view details)

Uploaded Jul 29, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64

hbctool_cli-0.18-cp312-cp312-macosx_11_0_arm64.whl (524.0 kB view details)

Uploaded Jul 29, 2026 CPython 3.12macOS 11.0+ ARM64

hbctool_cli-0.18-cp312-cp312-macosx_10_13_x86_64.whl (523.3 kB view details)

Uploaded Jul 29, 2026 CPython 3.12macOS 10.13+ x86-64

hbctool_cli-0.18-cp311-cp311-win_amd64.whl (524.5 kB view details)

Uploaded Jul 29, 2026 CPython 3.11Windows x86-64

hbctool_cli-0.18-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (582.5 kB view details)

Uploaded Jul 29, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64

hbctool_cli-0.18-cp311-cp311-macosx_11_0_arm64.whl (524.0 kB view details)

Uploaded Jul 29, 2026 CPython 3.11macOS 11.0+ ARM64

hbctool_cli-0.18-cp311-cp311-macosx_10_9_x86_64.whl (523.4 kB view details)

Uploaded Jul 29, 2026 CPython 3.11macOS 10.9+ x86-64

hbctool_cli-0.18-cp310-cp310-win_amd64.whl (524.5 kB view details)

Uploaded Jul 29, 2026 CPython 3.10Windows x86-64

hbctool_cli-0.18-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (578.6 kB view details)

Uploaded Jul 29, 2026 CPython 3.10manylinux: glibc 2.17+ x86-64

hbctool_cli-0.18-cp310-cp310-macosx_11_0_arm64.whl (524.0 kB view details)

Uploaded Jul 29, 2026 CPython 3.10macOS 11.0+ ARM64

hbctool_cli-0.18-cp310-cp310-macosx_10_9_x86_64.whl (523.4 kB view details)

Uploaded Jul 29, 2026 CPython 3.10macOS 10.9+ x86-64

hbctool_cli-0.18-cp39-cp39-win_amd64.whl (524.5 kB view details)

Uploaded Jul 29, 2026 CPython 3.9Windows x86-64

hbctool_cli-0.18-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (577.4 kB view details)

Uploaded Jul 29, 2026 CPython 3.9manylinux: glibc 2.17+ x86-64

hbctool_cli-0.18-cp39-cp39-macosx_11_0_arm64.whl (524.0 kB view details)

Uploaded Jul 29, 2026 CPython 3.9macOS 11.0+ ARM64

hbctool_cli-0.18-cp39-cp39-macosx_10_9_x86_64.whl (523.4 kB view details)

Uploaded Jul 29, 2026 CPython 3.9macOS 10.9+ x86-64

hbctool_cli-0.18-cp38-cp38-win_amd64.whl (524.4 kB view details)

Uploaded Jul 29, 2026 CPython 3.8Windows x86-64

hbctool_cli-0.18-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (579.3 kB view details)

Uploaded Jul 29, 2026 CPython 3.8manylinux: glibc 2.17+ x86-64

hbctool_cli-0.18-cp38-cp38-macosx_11_0_arm64.whl (523.8 kB view details)

Uploaded Jul 29, 2026 CPython 3.8macOS 11.0+ ARM64

hbctool_cli-0.18-cp38-cp38-macosx_10_9_x86_64.whl (523.1 kB view details)

Uploaded Jul 29, 2026 CPython 3.8macOS 10.9+ x86-64

File details

Details for the file hbctool_cli-0.18.tar.gz.

File metadata

Download URL: hbctool_cli-0.18.tar.gz
Upload date: Jul 29, 2026
Size: 471.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for hbctool_cli-0.18.tar.gz
Algorithm	Hash digest
SHA256	`7430278cd721ff5d7126f31c6422451ce1c01003920cfcaa1a5052755bd2ab96`
MD5	`cdcede6b867f600d9ce1bc7aefae8ca6`
BLAKE2b-256	`668e18d4e820e163f80f5a1eb4d35ea91b2691a316ff05100fb87ab05105885d`

Algorithm	Hash digest
SHA256	`8c062270aa845c00de2dff006b15b524791cf1c58bf05bd81ffeec072a86f749`
MD5	`36050639fb180f42b18e9791e7139f1e`
BLAKE2b-256	`f880e13c55dcca06ee2d7feb5d0f142cc579ce8d971319053b2fa6f6eab5a997`

Algorithm	Hash digest
SHA256	`bb7409dcbb008220d2516f527bf176ab228efc0e88c5cf71cbecbad9862e6b5c`
MD5	`7599a40c39cba4054c4f169cf9e7ce09`
BLAKE2b-256	`a37c489a0c022137dae5892fa46823405804951fd6f1a250d218dffeba9072f5`

Algorithm	Hash digest
SHA256	`e1639f9ec27a54d01a74dac228263f03be4a010850a2e01829463b9e3e459b0a`
MD5	`a47b67f156247ee4e78d1109d56d27fe`
BLAKE2b-256	`a49408346f056aab8c57caa2d8b740b78406478644de9b4deef5e9a1445fb77b`

Algorithm	Hash digest
SHA256	`78163d73adb77c5094c5d3f52b495a85f9c6e0ee68823ebe7c4e6b08d2191e91`
MD5	`fcfe342396f20bd08b6da897394e996f`
BLAKE2b-256	`2f04efaa67127179b958f3b6271627d8b176e1a175df728b8411c60b98ad69e4`

Algorithm	Hash digest
SHA256	`04db2a182e743279ccbb0edac552bf40ce8564088957192f2c1ffe66048abe4c`
MD5	`1df470546f65b24c24f1ad14f3011d6a`
BLAKE2b-256	`8cc2a50af58a0284d9f72ef0c6ee0b9b5e18e1b4a16385767e569a8822de87d6`

Algorithm	Hash digest
SHA256	`b47fd0498840ebe9210aa90e816969028941b92c4cd04e5425c2046a9c7216be`
MD5	`93a39b8fe1cb389ff053f59969a6f94d`
BLAKE2b-256	`7a42ebf7017103deef66913f29d9a5a4122a14091441c0d3fc3662fb09ffe431`

Algorithm	Hash digest
SHA256	`e5e0c4bd370cdf1b6b63d07e9fca0b5c546287ed755fd9ac88e66e4514a4d70a`
MD5	`7d662ebe0f1b21ef6d36fec0675bb0ef`
BLAKE2b-256	`0712b2a7b399d9fc8c1f32084bb4668b5df6bbc1991efd16e0ffdaa34095b072`

Algorithm	Hash digest
SHA256	`7f5d9aa9d306bdbb065d3afd00e3c3f7c8e08dfb70818b39d57a0e86c4557156`
MD5	`c771bd1baf4da1d4e9bdb420b2a7c15a`
BLAKE2b-256	`a0619ff07d248d8cfee1e1125875cb7379077663fc574b3cf247feb9824d5e2f`

Algorithm	Hash digest
SHA256	`aa2ac05521b3aa931e34c973bca6f6f9a6fd56ef676d0603f18e0457b2b6baf0`
MD5	`c289532945c7a2c2783c96694b412e0f`
BLAKE2b-256	`b153138c1c223e270266b02611b50a0ed22dbb0f0e109aa23a96fc467a3b035e`

Algorithm	Hash digest
SHA256	`598b7b027bc0db8143071edb7379ca879381a72c74e8f61f814f9342619b6d0b`
MD5	`abfac4a29a720b2104fecc3e339c91b0`
BLAKE2b-256	`357d7d09c570a6a0b5f1b8c013e6680e14337c37ba7f748d54382514d842cfd0`

Algorithm	Hash digest
SHA256	`cfe4894bbdadfb2f4c92e4f7e2d45a3f40a34162d865e3b00fe37c084c67d388`
MD5	`6bad6fbf7f73d934d1ddd6b5cc9e9e6c`
BLAKE2b-256	`992442f1ad40bfe83070bf1477e829ef90f3e28f99bdf372c1b84b4d471d839c`

Algorithm	Hash digest
SHA256	`bed0d2ddd244c18f1366239ce4d305f5cde3d5b2da1c4723e6531cda8d3a101b`
MD5	`9464654a85ab099b0b9638e2d2cdd12f`
BLAKE2b-256	`0a7ff8d89a84b1c6b83e22c14ec2a38c0d7ac1b9e41f5a6ca69c4813cecd605b`

Algorithm	Hash digest
SHA256	`b3720ed467c67b5b1392d45ed640f685e44e9e4ad0c80dd4f245f6bed52c9018`
MD5	`38789874d14717b94c7281a5c8c65be1`
BLAKE2b-256	`734e0a57c57f4c74a8974106151ca180842a9e2f30667fe5c574aeca5337c447`

Algorithm	Hash digest
SHA256	`ed605f14ae00225697cb0b49e29ddf97d6e0823de32e3bf5db09031aa5e69039`
MD5	`339b86c04f40ba45b7c5254317ea9946`
BLAKE2b-256	`b3af0ce2088ef829be7ba3ad531ae23e5d49f7667afd283f7fc2ff5730c1f2df`

Algorithm	Hash digest
SHA256	`ffe6a7719983b34123b80420dba13ed89aaacec47445d0a8f6d1a3a438c3745f`
MD5	`3fc26a77269d26860bbbcc1e45a9794b`
BLAKE2b-256	`3b71e12ffba6f94e373ad45e405d39311102133800b2c53c1d639712e3785615`

Algorithm	Hash digest
SHA256	`cca3604c914764680374fa9394a73a8584be6d4fafd3fe153fe5b32ce7e79ddb`
MD5	`1db643ee54012dec686ef9920c315460`
BLAKE2b-256	`5261cc80c0c8e6a0eda41f1999492166dced54f903cda3abba504bb0ed1be7ba`

Algorithm	Hash digest
SHA256	`2c64a22adde1dcb9a093070974c039e9a9b38a77869cdce542287c932a0acaaf`
MD5	`8b1e786a77061f25875e9f73b4cdf170`
BLAKE2b-256	`4fb558c172aa22925e313867394ff55c1a1e7d371f7257cd25f53122d9305887`

Algorithm	Hash digest
SHA256	`b73fa2d27e2951720596024001efad261165c1528537d6a3fa202b73802e5380`
MD5	`43fd9bc66a577208ef3743519c0f5a37`
BLAKE2b-256	`701dec91adee166b1fb878db4c9a3529193edb3ed4579cf057629a3bb6fd929b`

Algorithm	Hash digest
SHA256	`08bc89da3c44e9f46d73652b338adce402e0db1707150cd7e35fa2fda1830225`
MD5	`75b65a2f48d22c26714a452388fde6db`
BLAKE2b-256	`3bf828f1c0599bc7476218a95366748c9b1983779d25bcb714e84fffb3ab84cb`

Algorithm	Hash digest
SHA256	`295a7119672251471218fac8d0c93216361f2616c5569ae741591f51964aea9a`
MD5	`8abc8cb67627a3c1446fe962027d6fc4`
BLAKE2b-256	`d741be2f17ced2e806c85ed0e93d717c01e8ea4934c060e504d436f440a8cfcb`

hbctool-cli 0.18

Why hbctool

Features

Installation

Quick install

Local development install

PIPX INSTALL

Build the optional native extension

Usage

Output Layout

Benchmarking

Development

Credits

License

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

Algorithm	Hash digest
SHA256	`0b2a780d984350bb8c1b39b588fa9870e41958909e2e88dfd8c514a971c0cc7f`
MD5	`07a2c0ad2525044decf234f3cad8ad7d`
BLAKE2b-256	`49a48bd7dde702d6d638f9aa399fccc7a171e223c1f9d8a1a55dcde6ea1c9c7b`

Algorithm	Hash digest
SHA256	`a633031b7a2dd9a95e7c2e06261be3e3ea8cd1fe539cbbd0db6e96a6e1037fd3`
MD5	`a9df764421416dd33a6f878510beee8d`
BLAKE2b-256	`6b6db540299386e3930c62d25d35dcc9d1341017974181ba566dafae9ba7d4ab`

Algorithm	Hash digest
SHA256	`7c64f6c9d37daef6a215e4a2d1afc1de77de6b52a6e07e96374a2aee44b2a91f`
MD5	`b28028423fd44390b00d7cb53cbec575`
BLAKE2b-256	`940f81b2fa013a6dfede3e08f5753010f6bb2f128cb381980c26a176a50d5cdd`

Algorithm	Hash digest
SHA256	`e160b615c796018f80230dd9cbbd9ee7339a4177b7e8b08fdf2b3967c8e3edd2`
MD5	`bfcbd4258d467e6ee465f927babf54c4`
BLAKE2b-256	`8732cc9d109939eb022f2d7e383f63b0189a7507746065c2d3c68d4529c92f39`