Registry / devops / ida-hcli

ida-hcli

JSON →
library0.20.1pypypi✓ verified 22d ago

ida-hcli (Hex-Rays CLI Utility) is a command-line interface tool designed to interact with Hex-Rays IDA Pro installations. It assists with managing IDA versions, plugins, and configurations programmatically or via the terminal. Currently at version 0.17.2, it sees frequent updates, typically with minor releases several times a month.

pip install ida-hcli
INSTALL
IMPORT
SIG · IDA-HCLI
I
ida-hcli
devopspythonv0.20.1
Install
6.8s avg
Import
Disk
74MB
Pass rate
8/ 10
Env Coverage8 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v0.20.1 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
glibc
py 3.10
✓ —
✓ 7.9s
py 3.11
✓ —
✓ 7.2s
py 3.12
✓ —
✓ 6.5s
py 3.13
✓ —
✓ 5.5s
py 3.9
✕ build_error
✕ build_error
74MB installed
● package 74MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

HCLISettings
import hcli
from hcli import HCLISettings

This quickstart demonstrates how to invoke the `hcli` command-line utility programmatically using Python's `subprocess` module to check its installed version. `ida-hcli` is primarily a CLI tool, and this is the most common way to interact with it.

import subprocess try: # Run a basic hcli command to check its version result = subprocess.run(['hcli', '--version'], capture_output=True, text=True, check=True) print(f"hcli version: {result.stdout.strip()}") # Example of checking IDA Pro installations # result = subprocess.run(['hcli', 'check'], capture_output=True, text=True, check=True) # print(f"hcli check output:\n{result.stdout}") except FileNotFoundError: print("Error: 'hcli' command not found. Ensure ida-hcli is installed and in your PATH.") except subprocess.CalledProcessError as e: print(f"Error running hcli command: {e.cmd}") print(f"Stdout: {e.stdout}") print(f"Stderr: {e.stderr}")
ida-hcli --version
Debug
Known issues
gotchaPrior to v0.17.0, the help message for the `HCLI_CURRENT_IDA_INSTALL_DIR` environment variable on macOS was misleading, potentially causing confusion during setup.
fix
Upgrade to v0.17.0 or newer for clarified help messages related to IDA installation directories.
affects: <0.17.0
gotchaVersions before v0.16.0 had a less robust algorithm for detecting the correct Python executable associated with IDA Pro, which could lead to runtime errors or incorrect interpreter usage.
fix
Update to v0.16.0 or later to benefit from improved Python executable detection logic, ensuring better compatibility with various IDA Pro setups.
affects: <0.16.0
breakingBefore v0.16.0, explicit UTF-8 encoding was not consistently used across the library and for subprocesses. This could cause encoding-related errors or unexpected behavior when dealing with non-ASCII characters in paths, filenames, or output.
fix
Upgrade to v0.16.0 or higher. This version explicitly sets UTF-8 encoding for files and subprocesses, mitigating potential encoding issues.
affects: <0.16.0
Upgrade
Version history
0.20.1latest on PyPI · released Aug 26, 2026
Audit
Dependencies

No dependency data recorded yet.

Agent activity
16 hits · last 30 days
node
14
OpenAI (training)
1
Resources
ida-hcli — pip install ida-hcli · libregistry