> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crucihil.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install CruciHiL with pip — base package or with optional extras

## 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:

```bash theme={null}
python -m venv .venv
source .venv/bin/activate          # Linux / macOS
# .venv\Scripts\activate.bat       # Windows

pip install crucihil
```

Verify:

```bash theme={null}
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` |

<Note>
  `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.
</Note>

## Install from source

```bash theme={null}
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

```bash theme={null}
pip install --upgrade crucihil
# or with extras:
pip install --upgrade 'crucihil[analyze]'
```

***

<Card title="Quickstart →" icon="rocket" href="/quickstart">
  Run your first test against the virtual backend — no hardware required.
</Card>