Installation and Pixi setup¶

This project uses Pixi for reproducible environments and one-command task execution.

Install Pixi¶

Linux and macOS:

curl -fsSL https://pixi.sh/install.sh | sh

Windows installer:

https://github.com/prefix-dev/pixi/releases/latest/download/pixi-x86_64-pc-windows-msvc.msi

Windows PowerShell:

powershell -ExecutionPolicy ByPass -c "irm -useb https://pixi.sh/install.ps1 | iex"

Important

Restart your terminal or shell after installing Pixi so that the pixi command becomes available.

From the repository root:

pixi install

Pixi reads project dependencies from pyproject.toml and resolves them using pixi.lock.

Commit pixi.lock so that another machine can recreate the same package versions. This reduces dependency drift between machines.

For interactive work:

pixi shell

Inside the shell, commands such as python, pytest, and ruff run inside the project environment.

To rebuild from the existing lock file:

rm -rf .pixi
pixi install

To force a full dependency re-resolution:

rm -rf .pixi pixi.lock
pixi install

Warning

Deleting .pixi/ removes the local environment. Deleting pixi.lock allows dependency versions to change.