Langsung ke konten

Dokumentasi

Semua yang Anda perlukan untuk memasang dragoman, menghubungkan model, dan menjaganya tetap berjalan.

Pemasangan

Pasang dragoman dari toko browser Anda, dan dragoman akan terus diperbarui otomatis dari sana.

Chrome, Edge, Helium, dan browser Chromium lainnya
Instal rilis secara manual

Setiap rilis juga tersedia di GitHub, dengan file zip untuk browser Chromium dan Firefox, beserta kode sumber lengkapnya. Build yang dimuat manual tidak diperbarui otomatis.

  1. 1 Unduh zip Chrome dari rilis terbaru, lalu ekstrak.
  2. 2 Buka helium://extensions, atau chrome://extensions di browser lain, lalu aktifkan Mode developer.
  3. 3 Pilih Muat yang belum dibuka lalu pilih folder hasil ekstrak.
Buka rilis terbaru

Sematkan dragoman ke toolbar agar mudah dijangkau.

Chrome untuk Android tidak mendukung ekstensi. Di Android, gunakan Firefox.

Terjemahkan halaman pertama Anda

Buka situs web apa pun, klik ikon dragoman, pilih bahasa, lalu pilih Terjemahkan halaman. Alt+Shift+T, atau Option+Shift+T di Mac, melakukan hal yang sama dari keyboard. Draf tampil dengan garis bawah titik-titik keemasan, yang hilang saat model Anda menyempurnakan setiap paragraf.

AltShiftT / ⌥⇧T Terjemahkan halaman, atau tampilkan asli

Tampilan halaman yang diterjemahkan

Draf di perangkat Anda
Mochi saat ini dipromosikan ke editor dalam kepala.
Disempurnakan oleh model pilihan Anda
Kini Mochi sudah naik jabatan menjadi pemimpin redaksi.
Teks asli cukup diarahkan kursor
Arahkan kursor ke paragraf mana pun untuk membaca teks sebelumnya. Satu klik pada lencana, atau Alt+Shift+T, mengembalikan seluruh halaman.

Di ponsel atau tablet, buka dragoman dari menu ekstensi browser Anda.

Dibandingkan dengan penerjemah bawaan browser

Chrome, Edge, Safari, dan Firefox bisa menerjemahkan halaman sendiri, dan untuk sekilas lihat itu sering sudah cukup. dragoman untuk saat Anda ingin benar-benar membaca halaman: makna dan pilihan katanya tepat, dan Anda yang menentukan siapa yang melihat teksnya.

Membaca seluruh halaman

Penerjemah bawaan memproses halaman per potongan kecil secara terpisah, sehingga kata yang sama bisa diterjemahkan berbeda hanya beberapa baris kemudian. dragoman menunjukkan judul halaman, judul bagiannya, dan frasa yang berulang kepada model AI Anda, sehingga nama, label, atau istilah diterjemahkan sama dari awal hingga akhir.

Sepotong demi sepotong

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Period
Περίοδος
1928–1932
Tenure
Περίοδος
1933
Term

Dengan seluruh halaman dalam pandangan

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Term
Περίοδος
1928–1932
Term
Περίοδος
1933
Term
Ilustrasi: satu label Yunani yang berulang di sepanjang kotak info, diterjemahkan ke bahasa Inggris.

Anda yang menentukan ke mana teks pergi

Saat Chrome atau Edge menerjemahkan halaman, teksnya dikirim ke Google atau Microsoft. dragoman membuat draf di perangkat Anda, lalu hanya mengirim bagian yang sedang Anda baca ke penyedia pilihan Anda, dengan kunci Anda sendiri. Pilih tetap di perangkat, dan tidak ada teks halaman yang keluar sama sekali.

Ke mana teks halaman dikirim

Chrome Google Edge Microsoft dragoman Perangkat Anda Penyedia AI Anda hanya yang Anda baca, jika Anda menambahkan model
Anda yang memilih penerjemahnya
Chrome menerjemahkan halaman dengan Google Terjemahan, dan Edge dengan Microsoft Translator. dragoman bekerja dengan model AI pilihan Anda, entah itu Claude, Gemini, model di balik ChatGPT, atau model yang berjalan di komputer Anda sendiri. Model AI masa kini umumnya lebih piawai menangani ungkapan, nada, dan kata yang maknanya bergantung pada kalimat.
Teks asli tetap dekat
Arahkan kursor ke paragraf mana pun, atau ketuk di ponsel, untuk membaca teks aslinya tanpa mengembalikan seluruh halaman.

Penerjemah browser Anda sudah terpasang, gratis, dan tidak perlu disiapkan. Draf di perangkat dari dragoman juga gratis, dan penyempurnaan hanya dikenai biaya dari penyedia Anda untuk teks yang Anda baca, biasanya sangat kecil dengan model kecil. Penerjemah bawaan Firefox menjalankan Bergamot, mesin yang sama yang dipakai dragoman untuk draf di Firefox, jadi di sana bedanya ada pada penyempurnaan AI dan konteks halaman.

Di balik layar
Dua tahap
Model di perangkat milik browser Anda membuat draf di latar belakang, dan Bergamot, yang dikompilasi ke WebAssembly, mengisi bagian yang tidak tersedia. Paragraf di layar dan yang akan segera tampil lalu dikirim ke model Anda dalam kelompok kecil, dan setiap paragraf yang sudah disempurnakan menggantikan drafnya.
Konteks halaman
Setiap permintaan menyertakan judul halaman, kerangka judul bagiannya, frasa yang berulang di halaman beserta teks di sekitar kemunculan pertamanya, dan semua terjemahan yang sudah disepakati. Model mengembalikan istilah yang dipilihnya, dan permintaan berikutnya mengikutinya.
Markup
Tautan, penekanan, dan elemen sebaris lainnya dikirim sebagai placeholder bernomor, sehingga tata letak dan tautan kembali utuh.
Hanya yang Anda baca
Penyempurnaan mengikuti area yang terlihat, jadi halaman panjang hanya memakan biaya untuk bagian yang Anda gulir. Terjemahan yang selesai disimpan di perangkat Anda dan dipakai lagi saat Anda kembali.
Tanpa perantara
Permintaan langsung dikirim dari browser ke penyedia Anda dengan kunci Anda. Tidak ada server dragoman, dan seluruh kodenya terbuka untuk umum.

Terjemahan di perangkat

Setiap halaman dimulai di perangkat Anda. dragoman membuat draf dengan model di perangkat bawaan Chrome dan Edge, serta model Apple di Safari. Semuanya berjalan di komputer Anda, berbeda dengan fitur terjemahan halaman bawaan browser yang berjalan online. Di browser lainnya, dan untuk bahasa yang tidak didukung, Bergamot, mesin terbuka di balik Firefox Translations, membuat draf di dalam browser Anda. Semua ini tidak memerlukan akun atau kunci. Tanpa tambahan apa pun, Anda mendapat terjemahan yang cepat dan privat. Dengan model AI, draf tersebut menjadi versi awal yang dipoles oleh model Anda.

Unduhan sekali untuk setiap pasangan bahasa

  • Inggris → Turki 15 MB
  • Inggris → Jerman 26 MB
  • Prancis → Inggris 26 MB
  • Jepang → Inggris 49 MB

Prancis → Inggris → Jerman

52 MB

Tidak ada model langsung antara dua bahasa? dragoman melewati bahasa Inggris dan mengunduh kedua bagiannya.

Ukuran unduhan sesuai daftar di registri model Mozilla.
Bahasa
Lebih dari 50 bahasa, dari dan ke bahasa Inggris. Di antara dua bahasa lain, dragoman menerjemahkan lewat bahasa Inggris. Dalam daftar bahasa, yang bertanda Hanya AI memerlukan model AI.
Penggunaan pertama
Chrome dan Edge mengunduh paket bahasanya saat pertama kali Anda membutuhkannya, dan Safari memakai bahasa yang sudah diunduh untuk fitur terjemahan Apple di perangkat Anda. Pasangan bahasa Bergamot diunduh sekali dari Mozilla, biasanya 15 hingga 50 MB, dan disimpan di browser Anda. Setelah itu, semuanya bisa berjalan offline.
Terjemahan awal dan penyempurnaan
Terjemahan awal cepat dan cukup harfiah, pas untuk menangkap intinya. Model Anda menulis ulang dengan memperhatikan seluruh halaman, sehingga kalimatnya terasa alami serta nama dan istilahnya tetap konsisten.
Pilihan Anda
Agar halaman tetap di perangkat Anda meski model sudah disiapkan, aktifkan Hanya di perangkat ini di popup. Untuk melewati terjemahan awal dan menunggu model Anda, nonaktifkan Buat draf di perangkat ini dulu di Setelan.

Bergamot lahir dari proyek riset yang didanai Uni Eropa, dan Mozilla melatih serta menerbitkan model bahasa yang dijalankannya. Tentang Bergamot

Tambahkan model AI

Buka Setelan dari popup, pilih penyedia, dan ikuti tiga langkahnya. dragoman memeriksa kunci begitu Anda menempelnya dan memilihkan model yang cepat dan murah, yang bisa Anda ganti kapan saja.

Penyedia yang bisa Anda pakai

  • Anthropic
  • OpenAI
  • Google Gemini
  • OpenRouter
  • Mistral
  • DeepSeek
  • Groq
  • xAI
  • Ollama
  • LM Studio
  • Server apa pun yang kompatibel dengan OpenAI

OpenRouter dapat membuatkan kunci untuk Anda. Pilih Hubungkan dengan OpenRouter lalu setujui permintaannya.

Kunci Anthropic yang tidak terikat ke workspace juga memerlukan ID workspace. Anda dapat menemukannya di Anthropic Console pada Settings, lalu Workspaces.

Gunakan model lokal

Pasang Ollama, unduh model seperti gemma3, lalu jalankan dengan OLLAMA_ORIGINS disetel agar menerima permintaan dari ekstensi:

OLLAMA_ORIGINS="chrome-extension://*,moz-extension://*,safari-web-extension://*" ollama serve

Di LM Studio, muat model, aktifkan CORS di setelan server, lalu jalankan server lokal. dragoman akan menemukannya di localhost:1234.

Biayanya

dragoman gratis. Penyempurnaan memakai kunci Anda sendiri, jadi penyedia menagih Anda secara langsung. Model kecil dan cepat biasanya sudah cukup untuk menerjemahkan. Tab Penggunaan di Setelan menghitung token per model setiap bulan, dan mengaktifkan Tampilkan biaya tiap halaman akan menampilkan biaya halaman saat ini di samping lencana.

4 dari 14 paragraf disempurnakan

  • Disempurnakan
  • Draf awal
  • Belum

Saat Anda menggulir, paragraf yang akan muncul mendapat draf cepat, dan yang ada di layar disempurnakan. Sisa halaman tidak memakan biaya apa pun sampai Anda tiba di sana.

Privasi

Yang meninggalkan komputer Anda: paragraf di layar dan yang berikutnya, serta teks apa pun yang Anda minta diterjemahkan oleh pendamping Anda, dikirim ke penyedia pilihan Anda, dan, untuk bahasa yang tidak bisa diterjemahkan browser Anda sendiri, unduhan model satu kali dari Mozilla. Kunci Anda hanya dikirim ke penyedianya sendiri. dragoman tidak punya server, akun, maupun analitik.

Baca kebijakan privasi lengkap

Pemecahan masalah

Popup menyatakan halaman tidak dapat diterjemahkan

Halaman browser seperti setelan, halaman ekstensi, dan toko web tidak mengizinkan ekstensi mengubahnya. Buka situs web biasa.

Mesin di perangkat tidak punya model untuk pasangan ini

Penerjemah di perangkat mencakup bahasa yang paling banyak digunakan. Di Safari, Anda bisa menambahkan bahasa lain di Bahasa Terjemahan pada setelan Bahasa & Wilayah perangkat Anda. Untuk bahasa lainnya, tambahkan model AI dan dragoman akan langsung menerjemahkan dengannya.

Browser saya juga menawarkan untuk menerjemahkan halaman

dragoman meminta browser Anda untuk tidak ikut campur di halaman yang mungkin diterjemahkannya. Jika Anda mematikannya, aktifkan Jauhkan penerjemah browser saya di Setelan, bagian Bahasa. Jika browser Anda sudah menerjemahkan halaman, pilih Gunakan dragoman saja untuk memuatnya ulang dalam bahasa aslinya.

Model lokal tidak terhubung

Pastikan server berjalan dan alamatnya di Setelan sudah sesuai. Ollama memerlukan OLLAMA_ORIGINS, dan LM Studio memerlukan CORS diaktifkan.

dragoman tidak dapat membaca halaman

Safari dan Firefox memungkinkan Anda memilih situs web mana yang boleh dibaca ekstensi. Buka dragoman lalu pilih Izinkan di semua situs web.

Firefox tidak menyempurnakan dengan model saya

Firefox meminta izin sebelum ekstensi mengirim teks halaman ke mana pun. Buka Setelan lalu pilih Izinkan pengiriman teks halaman di bawah model Anda.

Build dari kode sumber

dragoman adalah sumber terbuka dengan lisensi MIT. Untuk mem-build-nya, Anda memerlukan Node 24 dan pnpm.

git clone https://github.com/firatciftci/dragoman.git
cd dragoman
pnpm install
pnpm dev:extension

Setiap browser punya build sendiri. Jalankan perintah ini dari extension/:

Browser Chromium pnpm build → .output/chrome-mv3
Firefox pnpm build:firefox → .output/firefox-mv3
Safari pnpm build:safari → .output/safari-mv3 Lalu build safari/dragoman.xcodeproj di Xcode.

Repositori ini berupa workspace pnpm:

extension/
Ekstensinya, dibuat dengan WXT dan Svelte
site/
Situs web ini, dibuat dengan SvelteKit
brand/
Para dragoman, logo, dan kotanya
messages/
Teks antarmuka dalam 85 bahasa