Download

Annotide runs on your own machine or in your own cloud. Every edition is the same download; a licence key adds users and the Business features. Without a key it runs as Community: free for up to three people, commercial use included.

Quick install (one command)

For a small team on a laptop, a workstation or a small server. Needs Docker with Compose v2, on Linux or macOS (Windows: inside WSL 2).

curl -fsSL https://annotide.com/install.sh | sh

The script installs into ~/annotide:

1. downloads compose.yaml: PostgreSQL, Redis, the API, a background worker and the web app,
2. writes a .env with a generated database password and signing key (readable only by you, never overwritten on a re-run),
3. starts everything and asks for the e-mail and password of the first administrator,
4. prints the address: http://localhost:8080.

Read install.sh first if you like; it is short, never needs root, and changes nothing outside ~/annotide.

Where your files go

Media stays where it is. The quick install comes with a local folder, ~/annotide/data, that you can register as storage under Settings → Connectors. You can also connect Azure Blob, S3 or Google Cloud Storage there instead: Annotide reads from them directly and never copies your files.

Upgrade, stop, remove

cd ~/annotide
docker compose pull && docker compose up -d   # upgrade to the latest release
docker compose down                           # stop (data is kept)
docker compose down -v                        # remove, including the database

Back up the database and ~/annotide/data before upgrading anything you care about; see Backup and restore.

Options

Set these before running the script, or edit ~/annotide/.env afterwards and run docker compose up -d:

Variable	Default	What it does
ANNOTIDE_DIR	~/annotide	Where to install
ANNOTIDE_PORT	8080	Port for the web app (only reachable from this machine)
ANNOTIDE_VERSION	latest	Pin a release, e.g. 0.1.0
COMPOSE_PROFILES=models	off	Also start the reference model service for pre-labelling
APP_LICENSE_KEY	none	Your licence key (or paste it under Settings → Licence)
APP_TELEMETRY_ENABLED=false	on	Turn off the weekly heartbeat (what it sends)

Teams and production: Kubernetes

For a team on a server everyone can reach, use the Helm chart on any Kubernetes cluster, with your own PostgreSQL, Redis and object storage.

helm install annotide oci://ghcr.io/annotide/charts/annotide

The Helm chart guide lists every value; the installation guide covers what you need first (database, Redis, storage, DNS and TLS) and the security checklist. On Azure, Terraform for Azure creates the cluster, database, Redis, storage and Key Vault, signed in with managed identities, with no passwords stored anywhere. On AWS and Google Cloud, Terraform for AWS and Terraform for Google Cloud create the same on EKS and GKE; there the database and Redis sign in with generated passwords, kept in the Terraform state and the chart’s Kubernetes Secret.

Python SDK and CLI

pip install annotide

A Python client, the annotide command line tool and an MCP server that lets AI agents such as Claude work with your projects. See the SDK guide. The reference training pipeline is pip install annotide-training (guide).

What gets installed

All images are built from one tagged release, signed with cosign and published for amd64 and arm64:

Image	What
ghcr.io/annotide/annotide-backend	API and background worker
ghcr.io/annotide/annotide-frontend	Web app
ghcr.io/annotide/annotide-model	Optional reference model service

Pricing

Community is free for up to three people. Team is €12 per user per month. See pricing

Documentation

Installation, the user guide, operations and backup. Read the docs