Installation

Annolid supports Python 3.10 to 3.13.

Recommended (uv)

uv provides fast, reproducible environment setup.

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Create and activate a virtual environment:

uv venv
source .venv/bin/activate

Install Annolid:

uv pip install annolid

Install from source (development):

git clone https://github.com/healthonrails/annolid.git
cd annolid
uv pip install -e .

pip Alternative

python -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install annolid

Verify Installation

annolid --help
annolid-run --help

Related Guides

• One-line install choices: docs/one_line_install_choices.md
• uv-focused setup: docs/install_with_uv.md