scripts/tts-generator/SETUP_UBUNTU.md

Setup rápido para resolver o problema do ambiente Python

Problema

O teu sistema Ubuntu/Debian protege o ambiente Python global com externally-managed-environment.

Solução Imediata

Opção 1 - Script Automático com Ambiente Virtual (RECOMENDADO):

chmod +x run_gemini_tts_venv.sh
./run_gemini_tts_venv.sh

Opção 2 - Manual com Ambiente Virtual:

# Criar e ativar ambiente virtual
python3 -m venv venv
source venv/bin/activate

# Instalar dependências
pip install google-genai

# Executar script
python gemini_tts.py

Opção 3 - Instalar System-wide (não recomendado):

pip install google-genai --break-system-packages
python gemini_tts.py

Opção 4 - Com pipx (se tiveres pipx instalado):

pipx install google-genai
python gemini_tts.py

Solução Definitiva

O script run_gemini_tts_venv.sh resolve automaticamente:

• Cria ambiente virtual isolado
• Instala dependências sem conflitos
• Executa o gerador de voz
• Mantém tudo organizado

Execute apenas:

./run_gemini_tts_venv.sh