Dokümanlar / Kurulum

Kurulum

Python, FFmpeg, PyTorch ve işlem aygıtını hazırlayın.

Gereksinimler

  • Windows 10 veya 11, 64-bit
  • Python 3.11–3.14, 64-bit
  • FFmpeg Shared ve FFprobe
  • Yaklaşık 4 GB boş depolama
  • NVIDIA GPU önerilir; CPU desteklenir ancak belirgin biçimde daha yavaştır

FFmpeg Shared kurulumu

PowerShell’i açın ve TorchCodec’in gerektirdiği shared FFmpeg paketini kurun:

winget install --id Gyan.FFmpeg.Shared -e

Kurulumdan sonra PowerShell’i yeniden açın. Statik Gyan.FFmpeg paketi TorchCodec’in ihtiyaç duyduğu shared DLL dosyalarını sağlamadığı için yeterli değildir.

LLMVoice kurulumu

En güncel resmi release installer’ı canonical website endpoint’inden indirin, ardından indirdiğiniz dosyayı ayrı bir komutla çalıştırın:

irm https://llmvoice.yusufdere.com/install.ps1 -OutFile install.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

Installer ne yapar

Installer:

  • Windows x64 desteğini doğrular ve Python 3.11–3.14 sürümlerini algılar;
  • desteklenen NVIDIA donanımını algılayıp CUDA veya CPU runtime profilini seçer;
  • release manifestini ve SHA256 doğrulamalı uygulama wheel’ini indirir;
  • %LOCALAPPDATA%\LLMVoice\runtime altında sürümlü ve izole runtime oluşturur;
  • FFmpeg shared DLL bootstrap, paket bütünlüğü, runtime importları, seçildiyse CUDA ve sentetik ses çözümlemeyi doğrular;
  • launcher ile install state’i atomik olarak yayınlar;
  • User PATH’e yalnızca %LOCALAPPDATA%\LLMVoice\bin yolunu ekler;
  • mevcut sesleri, modelleri, önbelleği ve yapılandırmayı korur.

Machine PATH’i değiştirmez, global Python ortamına kurulum yapmaz ve CUDA Toolkit kurmaz.

Installer seçenekleri

Normal kullanımda otomatik profil seçimi önerilir. İleri seviye seçeneklerle runtime veya release sabitlenebilir:

.\install.ps1 -Runtime auto
.\install.ps1 -Runtime cuda
.\install.ps1 -Runtime cpu
.\install.ps1 -Version 0.1.7
.\install.ps1 -Force
.\install.ps1 -Debug

Kurulumu doğrulama

User PATH değişikliğinin görünmesi için yeni bir terminal açın:

llmvoice --version
llmvoice doctor

Installer release dosyaları için ağ erişimi ister. İlk sentez ayrıca XTTS-v2 model ağırlıklarını indirebilir ve CPML model koşullarının kabulünü isteyebilir.

Geliştirme kurulumu

Editable kaynak kurulumları normal kullanıcılar için değil, katkıda bulunan geliştiriciler içindir. Geliştirme ortamı ve doğrulama adımları için LLMVoice repository README dosyasını kullanın.