Kurulum

Gerekenler

• Python 3.12 veya daha yeni (indir)

• uv — hızlı Python paket yöneticisi. Şununla yükleyin:

  macOS / LinuxWindows

  curl -LsSf https://astral.sh/uv/install.sh | sh
  

  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  

• Bir LLM API anahtarı — şunlardan herhangi biri:

  • Google Gemini (ücretsiz katman mevcut — başlamak için önerilen)
  • Herhangi bir OpenAI uyumlu endpoint (OpenAI, proxy üzerinden Anthropic, yerel Ollama / LM Studio, vb.)

İsteğe bağlı, ancak daha fazla özelliği açar

Araç	Şununla kullanılır	Ne zaman ihtiyacınız olur
FFmpeg (indir)	Altyazı, Ses, Dublaj, Live	Her ses/video iş akışı
LibreOffice (indir)	Linux/macOS'ta Office formatları	Legacy .doc / .xls / .ppt çevirisi, veya MS Office yüklü değilken herhangi bir Office dosyası
Tesseract (kurulum kılavuzu)	OCR motoru (varsayılan)	Metin Çıkar sayfası, taranmış PDF çevirisi, gömülü resim çevirisi
MS Office + pywin32	Windows'ta Office	Windows'ta en yüksek doğrulukta Office çevirisi

AI Translate'i bunların hiçbiri olmadan kurabilirsiniz — bunlara ihtiyaç duyan özellikler başarısız olmadan önce size söyler.

Kurulum

git clone https://github.com/cadic2603/ai-translate.git
cd ai-translate
uv sync

Bu, masaüstü uygulamasını, CLI'yi ve MCP sunucusunu çalıştırmak için gereken her şeyi kurar.

Çalıştırın

Masaüstü uygulamaKomut satırıMCP sunucusu

uv run python -m src.main

uv run ait --version

uv run ait-mcp           # stdio transport (Claude Desktop / Code için)

API anahtarınızı ekleyin

Masaüstü uygulamasını ilk açtığınızda:

1. Kenar çubuğundan Ayarlar'a tıklayın
2. LLM sekmesini açın
3. Google Gemini API anahtarınızı yapıştırın (veya OpenAI uyumlu özel bir sağlayıcı yapılandırın). Kurumsal kullanıcılar Gemini'yi Vertex AI moduna geçirebilir — bir GCP projesi ve bölgesine yönlendirin, isteğe bağlı olarak bir service-account JSON yolu sağlayın; ayrıntılar için LLM Sağlayıcıları'na bakın.
4. Varsayılan model seçin — herhangi bir mevcut Flash varyantı (örn. gemini-2.5-flash) sağlam bir ücretsiz başlangıç noktasıdır. Pro varyantları daha yüksek maliyetle daha iyi kalite verir.
5. Ayarları kapatın — bitti

Anahtarlar diskte düz metin olarak değil, OS keychain'inizde saklanır (macOS Keychain, Windows Credential Manager, Linux'ta GNOME / KDE Secret Service).

Headless / sunucu kurulumu

Anahtarları ayarlamak için masaüstü uygulamasını çalıştıramıyorsanız, keychain CLI komutları için LLM Sağlayıcıları'na bakın.

Sıradaki: deneyin

5 dakikalık ilk çeviri →