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

# Installation

> Install the Galtea CLI on your platform

The Galtea CLI ships as a single `galtea` binary, repackaged for the channels you already use. Pick the tab that matches your platform.

<Tabs>
  <Tab title="macOS & Linux (Homebrew)">
    If you have [Homebrew](https://brew.sh) (macOS) or [Linuxbrew](https://docs.brew.sh/Homebrew-on-Linux), the tap auto-installs on first use:

    ```bash theme={"system"}
    brew install galtea-ai/tap/galtea
    ```

    Apple Silicon, Intel macOS, and Linux on `x86_64` / `arm64` are all supported.
  </Tab>

  <Tab title="Linux (Debian/Ubuntu)">
    Add the Galtea APT repository (one-time GPG key + `sources.list` bootstrap), then install the CLI:

    ```bash theme={"system"}
    sudo install -m 0755 -d /etc/apt/keyrings

    curl -fsSL https://pkgs.galtea.ai/public.key \
      | sudo tee /etc/apt/keyrings/galtea.asc > /dev/null

    echo "deb [signed-by=/etc/apt/keyrings/galtea.asc] \
      https://pkgs.galtea.ai/apt stable main" \
      | sudo tee /etc/apt/sources.list.d/galtea.list

    sudo apt update
    sudo apt install galtea
    ```
  </Tab>

  <Tab title="Linux (Fedora/RHEL)">
    Add the Galtea YUM repository (one-time GPG key import + repo file), then install the CLI:

    ```bash theme={"system"}
    sudo rpm --import https://pkgs.galtea.ai/public.key

    sudo tee /etc/yum.repos.d/galtea.repo <<'EOF'
    [galtea]
    name=Galtea CLI
    baseurl=https://pkgs.galtea.ai/yum
    enabled=1
    gpgcheck=1
    gpgkey=https://pkgs.galtea.ai/public.key
    EOF

    sudo dnf install galtea
    ```

    Rocky Linux and AlmaLinux are supported via the same repository.
  </Tab>

  <Tab title="Python (any OS)">
    If you already have Python 3.9+ on your machine, you can install the CLI from PyPI:

    ```bash theme={"system"}
    pip install galtea-cli
    ```

    The PyPI package ships per-platform wheels that bundle the same `galtea` binary used by every other channel. The `galtea` console-script entry point lands on your `PATH` automatically.

    For more information, visit the [galtea-cli PyPI page](https://pypi.org/project/galtea-cli/).
  </Tab>
</Tabs>

### Verify installation

Once installed, confirm the binary is on your `PATH` and prints a version:

```bash theme={"system"}
galtea --version
```

### Update

Use the package-manager gesture native to the channel you installed from:

<Tabs>
  <Tab title="macOS & Linux (Homebrew)">
    ```bash theme={"system"}
    brew update && brew upgrade galtea
    ```
  </Tab>

  <Tab title="Linux (Debian/Ubuntu)">
    ```bash theme={"system"}
    sudo apt update && sudo apt upgrade galtea
    ```
  </Tab>

  <Tab title="Linux (Fedora/RHEL)">
    ```bash theme={"system"}
    sudo dnf upgrade galtea
    ```
  </Tab>

  <Tab title="Python (any OS)">
    ```bash theme={"system"}
    pip install --upgrade galtea-cli
    ```
  </Tab>
</Tabs>

### Uninstall

<Tabs>
  <Tab title="macOS & Linux (Homebrew)">
    ```bash theme={"system"}
    brew uninstall galtea

    # Optional: drop the tap entirely
    brew untap galtea-ai/tap
    ```
  </Tab>

  <Tab title="Linux (Debian/Ubuntu)">
    ```bash theme={"system"}
    sudo apt remove galtea
    ```
  </Tab>

  <Tab title="Linux (Fedora/RHEL)">
    ```bash theme={"system"}
    sudo dnf remove galtea
    ```
  </Tab>

  <Tab title="Python (any OS)">
    ```bash theme={"system"}
    pip uninstall galtea-cli
    ```
  </Tab>
</Tabs>

### Troubleshooting

If you run into any issues — installing, verifying, updating, or uninstalling — contact our support team at [support@galtea.ai](mailto:support@galtea.ai).