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

# Installation

> Install the canonic CLI via uv, pip, or Docker.

canonic ships as one distributable (CLI + local daemon). Local embeddings are an optional add-on.

<Tabs>
  <Tab title="uv">
    Primary channel for dev machines:

    ```bash theme={null}
    uvx canonic --version        # ephemeral, no install step
    uv tool install canonic      # persistent, global command
    ```
  </Tab>

  <Tab title="pip">
    Fallback for environments without `uv`:

    ```bash theme={null}
    pip install canonic
    ```
  </Tab>

  <Tab title="Docker">
    For CI, headless, or air-gapped environments:

    ```bash theme={null}
    docker pull ghcr.io/mischuh/canonic:latest
    ```
  </Tab>
</Tabs>

<Note>
  Package and image names shown throughout these docs illustrate the shape of each install channel. Exact names are confirmed per release.
</Note>

## Air-gapped install

Install from a local wheel directory with no outbound network calls during install:

```bash theme={null}
uv pip install --no-index --find-links ./wheels canonic
```

## Verify

```bash theme={null}
canonic --version
```

## Next steps

<Card title="Quickstart" icon="rocket" href="/quickstart">
  Point canonic at a local database and get your first answer in minutes.
</Card>