Vai al contenuto

Documentazione

Tutto ciò che ti serve per installare dragoman, collegare un modello e farlo funzionare.

Installazione

Installa dragoman dallo store del tuo browser: da lì si aggiornerà da solo.

Chrome, Edge, Helium e altri browser Chromium
Installa una release a mano

Ogni release è disponibile anche su GitHub, con gli zip per i browser Chromium e Firefox e il codice sorgente completo. Le build caricate a mano non si aggiornano da sole.

  1. 1 Scarica lo zip per Chrome dall'ultima versione ed estrailo.
  2. 2 Apri helium://extensions, o chrome://extensions in altri browser, e attiva la Modalità sviluppatore.
  3. 3 Scegli Carica estensione non pacchettizzata e seleziona la cartella estratta.
Apri l'ultima versione

Fissa dragoman alla barra degli strumenti per averlo a portata di clic.

Chrome per Android non supporta le estensioni. Su Android usa Firefox.

Traduci la tua prima pagina

Apri un sito web, fai clic sull'icona di dragoman, scegli una lingua e seleziona Traduci pagina. Alt+Shift+T, oppure Option+Shift+T su Mac, fa lo stesso da tastiera. Le bozze appaiono con una sottolineatura dorata punteggiata, che scompare man mano che il modello perfeziona ogni paragrafo.

AltShiftT / ⌥⇧T Traduci la pagina o mostra l'originale

Come si presenta una pagina tradotta

Abbozzato sul tuo dispositivo
Mochi è attualmente promosso a editore in capo.
Perfezionato dal modello che scegli
Nel frattempo Mochi è stato promosso a caporedattore.
L'originale è a portata di puntatore
Posa il puntatore su un paragrafo per leggere cosa diceva prima. Un clic sul badge, o Alt+Shift+T, ripristina l'intera pagina.

Su telefono o tablet, apri dragoman dal menu delle estensioni del browser.

Confronto con il traduttore del browser

Chrome, Edge, Safari e Firefox sanno tradurre le pagine da soli, e per un'occhiata veloce spesso basta. dragoman serve quando vuoi leggere davvero una pagina: rende bene il significato e le parole, e sei tu a decidere chi vede il testo.

Legge l'intera pagina

I traduttori integrati lavorano su piccoli pezzi della pagina, uno alla volta, così la stessa parola può uscire in due modi diversi a poche righe di distanza. dragoman mostra al tuo modello IA il titolo della pagina, i titoli delle sezioni e le frasi che si ripetono, così un nome, un'etichetta o un termine mantiene la stessa traduzione dall'inizio alla fine.

Pezzo per pezzo

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

Con tutta la pagina sott'occhio

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Term
Περίοδος
1928–1932
Term
Περίοδος
1933
Term
Un esempio: un'etichetta greca, ripetuta in un riquadro informativo, tradotta in inglese.

Decidi tu dove va il testo

Quando Chrome o Edge traducono una pagina, inviano il testo a Google o Microsoft. dragoman abbozza sul tuo dispositivo, poi invia solo ciò che stai leggendo al fornitore che hai scelto, con la tua chiave. Se resti sul dispositivo, nessun testo della pagina esce.

Dove va il testo della pagina

Chrome Google Edge Microsoft dragoman Il tuo dispositivo Il tuo fornitore di IA solo ciò che leggi, se aggiungi un modello
Il traduttore lo scegli tu
Chrome traduce le pagine con Google Traduttore, Edge con Microsoft Translator. dragoman funziona con il modello IA che scegli tu: Claude, Gemini, i modelli dietro ChatGPT o uno in esecuzione sul tuo computer. I modelli IA di oggi se la cavano in genere meglio con modi di dire, tono e parole il cui significato dipende dalla frase.
L'originale è sempre a portata di mano
Passa il mouse su un paragrafo, o toccalo sul telefono, per leggere com'era prima, senza riportare indietro tutta la pagina.

Il traduttore del browser è integrato, gratuito e non richiede configurazione. Anche le bozze di dragoman sul dispositivo sono gratuite, e il perfezionamento costa solo quanto il tuo provider addebita per il testo che leggi, di solito pochissimo con un modello piccolo. Il traduttore di Firefox usa Bergamot, lo stesso motore con cui dragoman abbozza in Firefox: lì la differenza sta nel passaggio IA e nel contesto della pagina.

Dietro le quinte
Due passaggi
Il modello sul dispositivo del browser abbozza in background, e Bergamot, compilato in WebAssembly, interviene dove manca. I paragrafi sullo schermo e quelli subito dopo passano poi al tuo modello in piccoli blocchi, e ogni paragrafo perfezionato sostituisce la sua bozza.
Contesto della pagina
Ogni richiesta include il titolo della pagina, uno schema dei suoi titoli, le frasi ricorrenti con il testo intorno alla loro prima comparsa e tutte le traduzioni già stabilite. Il modello restituisce i termini scelti e le richieste successive li rispettano.
Markup
Link, enfasi e altri elementi in linea viaggiano come segnaposto numerati, così layout e link tornano intatti.
Solo ciò che leggi
Il perfezionamento segue l'area visibile, così una pagina lunga costa solo la parte che scorri. Le traduzioni completate vengono salvate sul tuo dispositivo e riutilizzate quando torni.
Nessun intermediario
Le richieste vanno direttamente dal tuo browser al tuo provider con la tua chiave. Non c'è nessun server di dragoman, e ogni riga del codice è pubblica.

Traduzione sul dispositivo

Ogni pagina parte dal tuo dispositivo. dragoman abbozza con il modello sul dispositivo integrato in Chrome ed Edge, e con quello di Apple in Safari. Funzionano sul tuo computer, a differenza della traduzione delle pagine dei browser, che passa online. Ovunque altro, e per le lingue che non coprono, Bergamot, il motore aperto di Firefox Translations, abbozza dentro il browser. Niente account né chiavi. Da solo offre una traduzione rapida e privata. Con un modello IA, quelle bozze diventano una prima stesura che il modello rifinisce.

Un solo download per coppia di lingue

  • inglese → turco 15 MB
  • inglese → tedesco 26 MB
  • francese → inglese 26 MB
  • giapponese → inglese 49 MB

francese → inglese → tedesco

52 MB

Nessun modello diretto tra due lingue? dragoman passa dall'inglese e scarica entrambe le metà.

Dimensioni dei download come indicate nel registro dei modelli di Mozilla.
Lingue
Più di 50 lingue, da e verso l'inglese. Tra due altre lingue, dragoman passa dall'inglese. Nell'elenco delle lingue, quelle contrassegnate con Solo IA richiedono un modello IA.
Primo utilizzo
Chrome ed Edge scaricano i pacchetti di lingua la prima volta che servono, e Safari usa le lingue scaricate per la traduzione di Apple sul dispositivo. Le coppie di lingue di Bergamot si scaricano una volta da Mozilla, di solito da 15 a 50 MB, e restano nel browser. Dopo, tutto funziona offline.
Bozze e perfezionamento
Le bozze sono rapide e piuttosto letterali, utili per cogliere il senso. Il tuo modello le riscrive tenendo conto dell'intera pagina, così il testo suona naturale e nomi e termini restano coerenti.
A te la scelta
Per tenere una pagina sul tuo dispositivo anche con un modello configurato, attiva Solo su questo dispositivo nel popup. Per saltare le bozze e aspettare il tuo modello, disattiva Abbozza prima su questo dispositivo nelle Impostazioni.

Bergamot è nato da un progetto di ricerca finanziato dall'Unione europea, e Mozilla addestra e pubblica i modelli linguistici che utilizza. Scopri Bergamot

Aggiungi un modello IA

Apri le Impostazioni dal popup, scegli un fornitore e segui i tre passaggi. dragoman verifica la chiave appena la incolli e preseleziona un modello veloce ed economico, che puoi cambiare in qualsiasi momento.

Provider che puoi usare

  • Anthropic
  • OpenAI
  • Google Gemini
  • OpenRouter
  • Mistral
  • DeepSeek
  • Groq
  • xAI
  • Ollama
  • LM Studio
  • Qualsiasi server compatibile con OpenAI

OpenRouter può creare una chiave per te. Scegli Connetti con OpenRouter e approva la richiesta.

Le chiavi Anthropic non legate a un workspace richiedono anche un ID workspace. Lo trovi nella Anthropic Console in Impostazioni, poi Workspace.

Usa un modello locale

Installa Ollama, scarica un modello come gemma3 e avvialo con OLLAMA_ORIGINS impostato, così accetta le richieste dell'estensione:

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

In LM Studio carica un modello, attiva CORS nelle impostazioni del server e avvia il server locale. dragoman lo trova su localhost:1234.

Quanto costa

dragoman è gratuito. Il perfezionamento usa la tua chiave, quindi è il fornitore a fatturarti direttamente. Per tradurre di solito bastano modelli piccoli e veloci. La scheda Utilizzo nelle Impostazioni conta i token per modello ogni mese, e attivando Mostra il costo di ogni pagina vedrai il costo della pagina corrente accanto al badge.

4 di 14 paragrafi perfezionati

  • Perfezionato
  • Abbozzato
  • Non ancora

Mentre scorri, i paragrafi subito dopo ricevono una bozza veloce e quelli sullo schermo vengono perfezionati. Il resto della pagina non costa nulla finché non ci arrivi.

Privacy

Cosa lascia il tuo computer: i paragrafi sullo schermo e quelli subito dopo, più il testo che chiedi al tuo compagno di tradurre, inviati al provider che hai scelto, e, per le lingue che il browser non sa tradurre da solo, un download una tantum del modello da Mozilla. La tua chiave viene inviata solo al suo provider. dragoman non ha server, account né analisi.

Leggi l'informativa sulla privacy completa

Risoluzione dei problemi

Il popup dice che la pagina non si può tradurre

Le pagine del browser come le impostazioni, la pagina delle estensioni e gli store web non permettono alle estensioni di modificarle. Apri invece un normale sito web.

Il motore sul dispositivo non ha un modello per questa coppia

I traduttori sul dispositivo coprono le lingue più diffuse. In Safari puoi aggiungerne altre in Lingue di traduzione, nelle impostazioni Lingua e zona del dispositivo. Per le altre, aggiungi un modello IA e dragoman tradurrà direttamente con quello.

Anche il browser si offre di tradurre la pagina

dragoman chiede al browser di farsi da parte sulle pagine che potrebbe tradurre. Se hai disattivato questa opzione, attiva Tieni da parte il traduttore del browser in Impostazioni, sotto Lingue. Se il browser ha già tradotto una pagina, scegli Usa dragoman per ricaricarla in originale.

Un modello locale non si connette

Verifica che il server sia in esecuzione e che il suo indirizzo nelle Impostazioni corrisponda. Ollama richiede OLLAMA_ORIGINS, LM Studio richiede CORS attivo.

dragoman non riesce a leggere la pagina

Safari e Firefox ti permettono di scegliere quali siti web un'estensione può leggere. Apri dragoman e scegli Consenti su tutti i siti web.

Firefox non perfeziona con il mio modello

Firefox chiede il permesso prima che un'estensione invii altrove il testo della pagina. Apri Impostazioni e scegli Consenti l'invio del testo della pagina sotto il tuo modello.

Compila dal sorgente

dragoman è open source con licenza MIT. Per compilarlo ti servono Node 24 e pnpm.

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

Ogni browser ha la sua build. Esegui questi comandi da extension/:

Browser Chromium pnpm build → .output/chrome-mv3
Firefox pnpm build:firefox → .output/firefox-mv3
Safari pnpm build:safari → .output/safari-mv3 Poi compila safari/dragoman.xcodeproj in Xcode.

Il repository è un workspace pnpm:

extension/
L'estensione, realizzata con WXT e Svelte
site/
Questo sito web, realizzato con SvelteKit
brand/
I dragomanni, il logo e la città
messages/
Testi dell'interfaccia in 85 lingue