Installation - CruciHiL

Requirements

Python 3.10 or later (3.11+ recommended)
pip

CruciHiL itself is pure Python — no compilation step is needed to install it.

Install

We recommend a virtual environment:

python -m venv .venv
source .venv/bin/activate          # Linux / macOS
# .venv\Scripts\activate.bat       # Windows

pip install crucihil

Verify:

crucihil version
# crucihil 0.15.0

Optional extras

The base install covers everything in the quickstart. Install extras when you need them:

Extra	Command	What it adds
`analyze`	`pip install 'crucihil[analyze]'`	`crucihil analyze` / `crucihil author` — tree-sitter C/C++ parser for AI signal mapping
`frameworks`	`pip install 'crucihil[frameworks]'`	pytest / Robot Framework adoption layer — `run`, `verify`, and `author` with `--framework pytest\|robot`

crucihil analyze, crucihil author, and the analyze_component / author_component MCP tools require crucihil[analyze]. The base package will not import or reference tree-sitter. The SocketCAN and PEAK backends need no extra — python-can ships with the base install.

Install from source

git clone https://github.com/crucihil/crucihil.git
cd crucihil
pip install -e '.[analyze]'

Platform notes

Platform	Notes
Linux	Full support. SocketCAN backend works natively.
macOS	Full support for virtual backend. SocketCAN requires a USB adapter with a macOS driver.
Windows	Full support for virtual and PEAK backends. SocketCAN not available.

The virtual backend works identically on all platforms — use it for CI and local development regardless of OS.

Upgrading

pip install --upgrade crucihil
# or with extras:
pip install --upgrade 'crucihil[analyze]'

Quickstart →

Run your first test against the virtual backend — no hardware required.

​Requirements

​Install

​Optional extras

​Install from source

​Platform notes

​Upgrading

Quickstart →

Requirements

Install

Optional extras

Install from source

Platform notes

Upgrading