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

> Learn how to install the SDK and set up your environment

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

To install the Galtea Python SDK, use the following command:

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

For more information, visit the [Galtea PyPI page](https://pypi.org/project/galtea/).

### Requirements

Ensure you have the following prerequisites:

* Python 3.10 or higher
* pip (Python package installer)

### Setting Up Your Environment

1. **Create a Virtual Environment** (optional but recommended):

```bash theme={"system"}
python -m venv venv
source venv/bin/activate  # On Windows use `venv\Scripts\activate`
```

2. **Install the SDK**:

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

3. **Verify Installation** — initialize the client to confirm the SDK is working:

```python theme={"system"}
from galtea import Galtea

# Verify the SDK is properly installed by initializing it
# Note: Replace "YOUR_API_KEY" with your actual API key from the Galtea dashboard
galtea = Galtea(api_key="YOUR_API_KEY")
print("Galtea SDK installed successfully!")
```

### Upgrading the SDK

To upgrade to the latest version of the Galtea SDK, use the following command:

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

> [!WARNING]
>
> **Upgrading from 4.x to 5.0.0 changes names your code uses.** `galtea.tests` becomes
> `galtea.datasets`, and `galtea.traces` now means one input and one output rather than one step
> inside it. Read [Dataset, Trace, and Span Renames](https://docs.galtea.ai/v5.10/sdk/migration-guides/entity-renames.md) before
> you upgrade: some old calls keep running against a different entity instead of failing.

### Troubleshooting

If you encounter any issues during installation, 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.