Hızlı başlangıç

Size uygun yolu seçin. Hepsi ücretsiz ve açık kaynaklıdır (Apache 2.0).

Docker (web uygulaması)

docker pull ghcr.io/wsj-br/transrewrt:latest

docker run -d \
  -p 5000:5000 \
  -v transrewrt-data:/app/data \
  -e PROVIDER_API_KEY=your-api-key \
  --name transrewrt \
  ghcr.io/wsj-br/transrewrt:latest

PROVIDER_API_KEY öğesini sağlayıcınızın değişkeniyle değiştirin (örneğin OPENROUTER_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, XIA_API_KEY, …) ve değerini ayarlayın. Tam listeyi Yapılandırma bölümünde bulabilirsiniz.

Ardından http://localhost:5000 adresini açın ve hizmeti kullanıma sunmadan önce varsayılan yönetici parolasını değiştirin.

İpucu

Docker’da LLM kimlik bilgileri ortam değişkenleriyle (örneğin PROVIDER_API_KEY) ayarlanır. Bunlar web kullanıcı arayüzüne girilmez. Masaüstünde, anahtarları Ayarlar → API Yapılandırması bölümünde yapılandırırsınız.

Docker Compose

wget https://github.com/wsj-br/transrewrt/raw/refs/heads/master/production.yml -O transrewrt.yml
# Edit the file to add your API keys, or use a `.env` file. Set TZ if needed.
docker compose -f transrewrt.yml up -d

Windows

1. En son Transrewrt Setup x.y.z.exe dosyasını Sürümler sayfasından indirin.
2. Yükleyiciyi çalıştırın.
3. Uygulamayı açın ve API anahtarlarını Ayarlar → API Yapılandırması bölümüne girin. En az bir sağlayıcı yapılandırın; OpenRouter, ücretsiz modeller için yaygın bir seçimdir.

Not

Windows, uygulamayı yüklerken UAC veya SmartScreen uyarıları gösterebilir. Resmi GitHub Sürümleri sayfasından indirirseniz yüklemek güvenlidir. Yüklemek için “Daha fazla bilgi” ve “Yine de çalıştır”a tıklayın.

Linux

CPU’nuz için .AppImage dosyasını Sürümler sayfasından indirin (Raspberry Pi 4+ dahil x64 veya arm64):

chmod +x Transrewrt-x.y.z-x64.AppImage && ./Transrewrt-x.y.z-x64.AppImage

API anahtarlarını Ayarlar → API Yapılandırması bölümüne girin.

Chromium GPU / EGL hataları yazdırıyor ancak uygulama çalışıyorsa, donanım hızlandırmayı devre dışı bırakabilirsiniz:

TRANSREWRT_DISABLE_GPU=1 ./Transrewrt-x.y.z-arm64.AppImage

macOS

Mac’iniz için .dmg’i Sürümler sayfasından indirin:

• Apple Silicon — Transrewrt-x.y.z-arm64.dmg
• Intel — Transrewrt-x.y.z-x64.dmg

Disk görüntüsünü açın ve Transrewrt’i Uygulamalar’a sürükleyin. API anahtarlarını Ayarlar → API Yapılandırması bölümüne girin.

Not

macOS derlemesi imzasızdır (Apple noter tasdiki yok). Gatekeeper ilk başlatmayı engeller. Transrewrt.app’e sağ tıklayın ve Aç’ı seçin, ardından Aç’ı onaylayın.

Veya karantina özniteliğini temizleyin:

xattr -dr com.apple.quarantine /Applications/Transrewrt.app

Güncelleme

• Windows — Sürümler sayfasından daha yeni Transrewrt Setup x.y.z.exe’i indirin ve çalıştırın. Ayarlar ve veriler korunur.
• Linux — daha yeni .AppImage’i indirin ve eski dosyayı değiştirin. Ayarlar ve veriler korunur.
• macOS — daha yeni .dmg’i indirin, açın ve Transrewrt’i Uygulamalar’a sürükleyerek mevcut uygulamayı değiştirin. Ayarlar ve veriler korunur.
• Docker — yeni görüntüyü çekin ve kapsayıcıyı yeniden oluşturun. Veriler /app/data biriminde kalır:

docker pull ghcr.io/wsj-br/transrewrt:latest
docker stop transrewrt && docker rm transrewrt
# then run the same `docker run` command as above
# or, with Docker Compose:
docker compose -f transrewrt.yml pull && docker compose -f transrewrt.yml up -d

Sonraki adımlar

1. Bir API anahtarı alın
2. Her şeyin çalıştığını doğrulamak için basit bir çeviri yapın
3. Çevir, Yeniden Yaz ve Dönüştür kılavuzlarını okuyun