> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/yocxy2/chatterboxyocxy/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install Chatterbox TTS and set up your environment

Chatterbox TTS is available as a Python package and can be installed via pip or from source. The package supports CUDA, CPU, and Apple Silicon (MPS) for inference.

## Prerequisites

<Note>
  Chatterbox requires **Python 3.10 or higher**. The package was developed and tested on Python 3.11 on Debian 11 OS.
</Note>

### Hardware Requirements

Chatterbox TTS supports multiple hardware configurations:

* **CUDA** - NVIDIA GPUs with CUDA support (recommended for best performance)
* **CPU** - Any modern CPU (slower inference)
* **MPS** - Apple Silicon (M1/M2/M3) with Metal Performance Shaders

## Installation Methods

<CodeGroup>
  ```bash pip theme={null}
  pip install chatterbox-tts
  ```

  ```bash source theme={null}
  # Optional: Create a conda environment
  # conda create -yn chatterbox python=3.11
  # conda activate chatterbox

  git clone https://github.com/resemble-ai/chatterbox.git
  cd chatterbox
  pip install -e .
  ```
</CodeGroup>

<Tip>
  Installing from source allows you to modify the code or dependencies. The versions of all dependencies are pinned in `pyproject.toml` to ensure consistency.
</Tip>

## Verify Installation

After installation, verify that Chatterbox is working correctly:

```python theme={null}
import torch
from chatterbox.tts_turbo import ChatterboxTurboTTS

# Check available device
if torch.cuda.is_available():
    device = "cuda"
elif torch.backends.mps.is_available():
    device = "mps"
else:
    device = "cpu"

print(f"Using device: {device}")

# Load the model
model = ChatterboxTurboTTS.from_pretrained(device=device)
print("Chatterbox TTS installed successfully!")
```

## Next Steps

Now that you have Chatterbox installed, you can:

* Follow the [Quick Start Guide](/quickstart) to generate your first audio
* Explore the different models available in the Model Zoo
* Learn about voice cloning and paralinguistic tags