# ACE-Step Kurulum Rehberi

Bu kurulum ACE-Step'i tamamen `D:\__sistem__\Masaustu\FikoYT.Yeni.Cag\video-uretim\ace-step` klasörüne yerleştirir. Sistem genelinde hiçbir değişiklik yapılmaz; modeller, sanal Python ortamı ve HuggingFace cache'i de bu klasörün içine düşer.

## Klasör yapısı (kurulumdan sonra)

```
video-uretim\
├── ACE-Step-Kur.bat          <- TEK TIK KURULUM
├── ACE-Step-Baslat.bat       <- Web arayüzünü açar
├── ACE-Step-Guncelle.bat     <- Güncelleme
└── ace-step\                 <- Her şey burada
    ├── ACE-Step\             <- Kaynak kod (git repo)
    ├── .venv\                <- İzole Python ortamı
    ├── models\               <- Checkpoint modelleri
    ├── hf-cache\             <- HuggingFace cache (~10 GB)
    ├── torch-cache\          <- PyTorch cache
    └── outputs\              <- Üretilen müzikler
```

## Gereksinimler

1. **Python 3.10 veya 3.11** (python.org'dan kurun, kurulumda "Add to PATH" işaretli olsun)
2. **Git for Windows** (git-scm.com)
3. **NVIDIA sürücüsü** (sizde zaten var — CUDA 12.1 uyumlu)
4. Yaklaşık **15 GB boş disk alanı** (PyTorch + modeller)

## Kurulum adımları

1. **`ACE-Step-Kur.bat` dosyasına çift tıklayın.**
   - Script Python ve Git'in yüklü olduğunu kontrol eder.
   - `ace-step\` klasörünü oluşturur.
   - GitHub'dan ACE-Step kaynak kodunu klonlar.
   - `ace-step\.venv` içinde izole Python ortamı kurar.
   - PyTorch CUDA 12.1'i ve ACE-Step bağımlılıklarını kurar.
   - Kurulum süresi: internet hızına bağlı, ~10–20 dakika.

2. Kurulum bittiğinde ekrana `KURULUM TAMAM!` yazar.

## Çalıştırma

- **`ACE-Step-Baslat.bat`** dosyasına çift tıklayın.
- Tarayıcıda `http://127.0.0.1:7865` adresini açın.
- **İlk çalıştırmada ~10 GB model** `ace-step\hf-cache` klasörüne indirilir. Sonraki çalıştırmalarda anında açılır.

## Güncelleme

Yeni versiyon çıktığında `ACE-Step-Guncelle.bat` dosyasını çalıştırın.

## Sorun giderme

**"Python bulunamadı" hatası:**
Python'u python.org'dan kurun ve kurulum sırasında "Add Python to PATH" seçeneğini işaretleyin.

**"CUDA available: False" çıkıyor:**
- `nvidia-smi` komutunu bir Komut İsteminde çalıştırın, kartınız görünmeli.
- Görünmüyorsa NVIDIA sürücüsünü güncelleyin.

**"pip install -e . basarisiz":**
`ace-step\ACE-Step\requirements.txt` elle kurulmayı dener — genellikle otomatik devreye girer.

**Port 7865 kullanımda:**
`ACE-Step-Baslat.bat` dosyasındaki `--port 7865` değerini örn. `--port 7866` olarak değiştirin.

**Temiz baştan kurulum:**
`ace-step\` klasörünü komple silip `ACE-Step-Kur.bat` dosyasını tekrar çalıştırın. Tek klasör silmek kurulumu sıfırlar — sistemde başka hiçbir iz kalmaz.

## Notlar

- Batch dosyalarındaki env değişkenleri (`HF_HOME`, `TORCH_HOME`, `HUGGINGFACE_HUB_CACHE`) sayesinde HuggingFace asla `%USERPROFILE%\.cache` klasörüne yazmaz — her şey `ace-step\` altında kalır.
- Sanal ortam `.venv` sayesinde sistem Python'unuz kirlenmez.
- Tüm kurulum taşınabilir: `ace-step` klasörünü başka bir yere kopyalarsanız sadece bat dosyalarındaki `KOK` yolunu güncellemeniz yeterli.