> ## 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

> [!WARNING]
>
> You are reading the docs of Galtea 5.12. [Read this page in the latest version](https://docs.galtea.ai/cli/installation.md).

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

> [tab] 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] 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] 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] 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/).

### 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:

> [tab] macOS & Linux (Homebrew)
>
> ```bash theme={"system"}
> brew update && brew upgrade galtea
> ```

> [tab] Linux (Debian/Ubuntu)
>
> ```bash theme={"system"}
> sudo apt update && sudo apt upgrade galtea
> ```

> [tab] Linux (Fedora/RHEL)
>
> ```bash theme={"system"}
> sudo dnf upgrade galtea
> ```

> [tab] Python (any OS)
>
> ```bash theme={"system"}
> pip install --upgrade galtea-cli
> ```

### Uninstall

> [tab] macOS & Linux (Homebrew)
>
> ```bash theme={"system"}
> brew uninstall galtea
>
> # Optional: drop the tap entirely
> brew untap galtea-ai/tap
> ```

> [tab] Linux (Debian/Ubuntu)
>
> ```bash theme={"system"}
> sudo apt remove galtea
> ```

> [tab] Linux (Fedora/RHEL)
>
> ```bash theme={"system"}
> sudo dnf remove galtea
> ```

> [tab] Python (any OS)
>
> ```bash theme={"system"}
> pip uninstall galtea-cli
> ```

### Troubleshooting

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.