CAAL + Chatterbox Multilingual TTS 🎙️

Windows için Türkçe destekli sesli asistan kurulumu

---

🌟 Özellikler

• ✅ 23 Dil Desteği (Türkçe dahil: tr)
• ✅ Windows Uyumlu (GPU + CPU desteği)
• ✅ Zero-shot Voice Cloning (10 saniyelik ses ile)
• ✅ Emotion Control (duygu yoğunluğu ayarı)
• ✅ 16GB RAM için Optimize
• ✅ Real-time TTS (ses üretimi)
• ✅ MIT Lisansı (açık kaynak)

---

📋 Gereksinimler

Minimum:

• OS: Windows 10/11
• RAM: 16GB
• Python: 3.11
• GPU: NVIDIA GPU (opsiyonel, yoksa CPU'da çalışır)
• Disk: ~5GB

Önerilen:

• GPU: NVIDIA RTX 3060/4060 (8GB VRAM)
• CUDA: 12.1

---

🚀 Hızlı Kurulum

1. Repoyu İndirin

git clone https://github.com/hic000/CAAL-Chatterbox.git
cd CAAL-Chatterbox

2. Otomatik Kurulum (Windows)

install_windows.bat

Bu script:

• Python 3.11 kontrolü yapar
• Virtual environment oluşturur
• PyTorch + CUDA yükler
• Chatterbox TTS kurar
• Tüm bağımlılıkları yükler

3. Test Edin

python test_chatterbox.py

---

📖 Manuel Kurulum

Adım 1: Python 3.11

# Windows için indirin:
https://www.python.org/downloads/release/python-3119/

# Kurulum sırasında "Add to PATH" seçin!

# Kontrol:
python --version  # Python 3.11.9

Adım 2: Virtual Environment

python -m venv venv
venv\Scripts\activate

Adım 3: PyTorch (GPU Destekli)

pip install torch==2.5.1+cu121 torchvision==0.20.1+cu121 torchaudio==2.5.1+cu121 --index-url https://download.pytorch.org/whl/cu121

CPU-only (GPU yoksa):

pip install torch torchvision torchaudio

Adım 4: Chatterbox

pip install chatterbox-tts transformers accelerate scipy numpy soundfile

---

💻 Kullanım

Basit Örnek (Türkçe)

from voice_chatterbox import VoiceEngine

# Motor başlat
engine = VoiceEngine(default_language="tr")

# Türkçe konuş
engine.speak(
    "Merhaba! Ben Chatterbox, Türkçe konuşabilen yapay zeka sesli asistanım.",
    language="tr"
)

Voice Cloning Örneği

# 10+ saniyelik referans ses ile klonlama
engine.speak_with_voice_clone(
    text="Bu ses kendi sesinizle klonlanmış olacak!",
    reference_audio="my_voice.wav",
    language="tr"
)

Emotion Control (Duygu Ayarı)

# Sakin/nötr
engine.speak("Sakin bir tonla konuşuyorum.", exaggeration=0.3)

# Duygusal/dramatik
engine.speak("ÇOK HEYECANLI BİR ŞEKİLDE KONUŞUYORUM!", exaggeration=0.8)

Desteklenen Diller

# 23 dil kodu:
languages = [
    'ar', 'da', 'de', 'el', 'en', 'es', 'fi', 'fr', 
    'he', 'hi', 'it', 'ja', 'ko', 'ms', 'nl', 'no', 
    'pl', 'pt', 'ru', 'sv', 'sw', 'tr', 'zh'
]

# İngilizce
engine.speak("Hello world!", language="en")

# Almanca
engine.speak("Guten Tag!", language="de")

---

📁 Dosya Yapısı

CAAL-Chatterbox/
├── voice_chatterbox.py          # Ana TTS motoru
├── test_chatterbox.py           # Test scripti
├── install_windows.bat          # Otomatik kurulum
├── CAAL_CHATTERBOX_SETUP.md     # Detaylı kurulum rehberi
├── README.md                    # Bu dosya
├── requirements.txt             # Python bağımlılıkları
├── outputs/                     # Oluşturulan sesler
└── reference_audio/             # Voice cloning için referans sesler

---

🔧 Parametre Rehberi

exaggeration (Duygu Yoğunluğu)

Değer	Açıklama
0.0-0.3	Sakin, nötr, monoton
0.4-0.6	Dengeli (varsayılan: 0.5)
0.7-1.0	Duygusal, dramatik, abartılı

cfg_weight (Ses Kalitesi)

Değer	Açıklama
0.0-0.3	Hızlı konuşma
0.4-0.6	Dengeli (varsayılan: 0.5)
0.7-1.0	Yavaş, net, dikkatli konuşma

---

🐛 Sorun Giderme

Hata: "torchvision::nms does not exist"

# PyTorch ve torchvision sürümlerini hizala
pip uninstall torch torchvision torchaudio -y
pip install torch==2.5.1+cu121 torchvision==0.20.1+cu121 torchaudio==2.5.1+cu121 --index-url https://download.pytorch.org/whl/cu121

Hata: "CUDA out of memory"

# CPU'ya geç
engine = VoiceEngine(device="cpu")

Yavaş Ses Üretimi

• GPU kullanıyorsanız: CUDA driver güncel mi kontrol edin
• CPU kullanıyorsanız: Normal (GPU 10x daha hızlı)

---

📊 Performans

16GB RAM Sisteminde:

Donanım	İlk Yükleme	Ses Üretimi (10s)	VRAM
RTX 3060 8GB	~10 saniye	~2 saniye	4.5 GB
RTX 4060 8GB	~8 saniye	~1.5 saniye	4.5 GB
CPU Only	~30 saniye	~15 saniye	RAM: 6 GB

---

🎓 Kaynaklar

• Chatterbox GitHub: https://github.com/resemble-ai/chatterbox
• HuggingFace Model: https://huggingface.co/ResembleAI/chatterbox-multilingual
• Gradio Demo: https://huggingface.co/spaces/ResembleAI/Chatterbox-Multilingual-TTS
• CAAL Orijinal Repo: https://github.com/CoreWorxLab/CAAL

---

📝 Lisans

Bu proje MIT lisansı altında dağıtılmaktadır.

• Chatterbox TTS: MIT License (Resemble AI)
• CAAL: Orijinal lisans (CoreWorxLab)

---

👤 Geliştirici

GitHub: @hic000

Hazırlayan: Claude (Anthropic) - 13 Şubat 2026

---

⭐ Star Verin!

Bu repo işinize yaradıysa lütfen ⭐ verin!

---

🙏 Teşekkürler

• Resemble AI - Chatterbox TTS geliştirme ekibi
• CoreWorxLab - CAAL projesi
• Anthropic - Claude AI asistanı

---

Made with ❤️ for Turkish AI Community