Bikin endpoint DeepLX lokal sendiri pakai model translasi bawaan Firefox lewat LinguaSpark. Setup ini jalan full offline via Docker Compose, hemat RAM, dan responsnya kencang tanpa takut kena limit atau blokir rate limit penyedia API publik. Cocok banget buat nyuplai kebutuhan token Agent atau ekstensi browser harian kamu tanpa bayar sepeser pun.
Mengenal Layanan & Gambaran Teknis
LinguaSpark adalah server terjemahan berbasis Rust yang mengeksekusi model offline milik Mozilla Firefox Translations di mesin lokal. Server ini menyediakan antarmuka API yang kompatibel dengan format DeepLX, jadi software atau ekstensi translator bisa langsung diarahkan ke localhost tanpa perlu bayar langganan API berbayar.
Panduan Langkah Demi Langkah
- Langkah 1 — Buka repositori proyek di github.com/LinguaSpark/server untuk melihat dokumentasi dasar, lalu buat folder kerja baru di komputer kamu.
- Langkah 2 — Buat file bernama compose.yml di dalam folder tersebut, isi dengan konfigurasi image ghcr.io/linguaspark/server:main, port 3000:3000, dan mounting volume./models:/app/models.
- Langkah 3 — Di direktori yang sama, bikin sub-folder models, lalu buat sub-direktori pasangan bahasa di dalamnya sesuai kebutuhan, contohnya en-zh (Inggris ke Mandarin) dan zh-en (Mandarin ke Inggris).
- Langkah 4 — Buka URL database model Firefox di searchfox.org/firefox-release/source/services/settings/dumps/main/translations-models.json untuk mengambil link download file model berformat binar (.bin/.lex) dari Mozilla CDN, lalu unduh dan letakkan ke sub-folder bahasa yang bersangkutan.
- Langkah 5 — Jalankan container dengan perintah terminal 'docker compose up -d' di folder tersebut, lalu arahkan aplikasi translator kamu ke http://localhost:3000.
Persyaratan & Kesiapan
- Docker dan Docker Compose sudah terinstal di komputer atau VPS.
- Ruang disk kosong minimal 1-2 GB untuk menampung container image dan bobot file model.
- Koneksi internet untuk proses unduh image container dan file model Mozilla CDN pertama kali.
Tips Optimalisasi
- Pasang proteksi pada parameter environment API_KEY di compose.yml jika kamu berniat membuka akses port server ini ke publik.
- Pilih file model versi terbaru di daftar JSON Mozilla agar akurasi dan pemilihan kosakata terjemahan lebih natural.
Mitigasi Risiko & Keamanan
- Kualitas terjemahan model lokal Mozilla fokus pada efisiensi bobot ringan, sehingga hasil terjemahan kalimat sastra kompleks tidak sebaik LLM komersial berbayar.
- Struktur penamaan file model di dalam folder harus presisi mengikuti standar LinguaSpark agar engine dapat membaca model saat container boot.
Kesimpulan & Catatan Penting
LinguaSpark jadi solusi jitu buat kamu yang butuh API terjemahan tanpa batasan kuota dan anti-blokir. Setup sekali via Docker, dan kamu punya endpoint terjemahan mandiri yang siap dipakai 24/7.
Rujukan data terverifikasi dan pembaruan kuota secara realtime dapat dipantau langsung melalui portal intelijen direktori digital AICHECK #65451.