# Cài Đặt

Source: https://docs.vieneu.io/vi/docs/getting-started/installation

## Yêu Cầu Trước

- **Python 3.10+**
- **eSpeak NG** — Bắt buộc để phiên âm

### Cài Đặt eSpeak NG

```bash
# macOS
brew install espeak

# Ubuntu/Debian
sudo apt install espeak-ng

# Fedora/Amazon Linux
sudo dnf install espeak

# Windows
# Tải .msi từ https://github.com/espeak-ng/espeak-ng/releases
```

### Tuỳ Chọn: GPU NVIDIA

Để đạt tốc độ tối đa qua LMDeploy hoặc tăng tốc GGUF GPU:
- NVIDIA Driver >= 570.65 (CUDA 12.8+)
- [NVIDIA GPU Computing Toolkit](https://developer.nvidia.com/cuda-downloads)

## Cài Từ Mã Nguồn (Khuyên Dùng)

```bash
git clone https://github.com/pnnbao97/VieNeu-TTS.git
cd VieNeu-TTS
```

### Hỗ Trợ GPU (Mặc Định)

```bash
uv sync
```

### Chỉ CPU (Nhẹ Hơn)

```bash
# Linux/macOS
cp pyproject.toml pyproject.toml.gpu
cp pyproject.toml.cpu pyproject.toml
uv sync
```

## Cài Như Package Python

```bash
# Windows (tối ưu CPU)
pip install vieneu --extra-index-url https://pnnbao97.github.io/llama-cpp-python-v0.3.16/cpu/

# macOS (tăng tốc Metal GPU)
pip install vieneu --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/metal/

# Linux / Chung
pip install vieneu
```

## Xác Minh Cài Đặt

```python
from vieneu import Vieneu

tts = Vieneu()
audio = tts.infer(text="Xin chào")
tts.save(audio, "test.wav")
print("Cài đặt thành công!")
```