Skip to content

Installing Annolid with uv

This is the recommended development-style setup for this repository and matches the local validation guidance used in the repo instructions.

Prerequisites

1. Clone the Repository

git clone --recurse-submodules https://github.com/healthonrails/annolid.git
cd annolid

2. Create .venv

uv venv .venv --python 3.11
source .venv/bin/activate

On Windows PowerShell:

uv venv .venv --python 3.11
.venv\Scripts\Activate.ps1

3. Install Annolid

GUI-capable editable install:

uv pip install -e ".[gui]"

If you also need Annolid Bot integrations:

uv pip install -e ".[gui,annolid_bot]"

4. Verify

annolid --help
annolid-run --help
annolid-run list-models

5. Launch

annolid

Notes for Current Codebase

  • The current terminal command is annolid-run, not older annolid-train or annolid-track commands.
  • The repo’s local validation instructions assume a repository-local .venv.
  • Optional extras are defined in pyproject.toml; install only what you need.

Troubleshooting

  • If Qt bindings are missing, reinstall with the gui extra.
  • If FFmpeg tools are missing, install ffmpeg with your package manager or conda-forge.
  • If Annolid Bot features are missing, ensure you installed the annolid_bot extra and configured the relevant runtime files.
  • If you want a fully reproducible dependency state, keep uv.lock in sync with your environment and use the repo’s validation checks.