Aller au contenu

Documentation

Tout ce qu'il faut pour installer dragoman, connecter un modèle et le faire fonctionner.

Installation

Installez dragoman depuis la boutique de votre navigateur : il s'y mettra à jour tout seul.

Chrome, Edge, Helium et autres navigateurs Chromium
Installer une version manuellement

Chaque version est aussi publiée sur GitHub, avec des zips pour les navigateurs Chromium et Firefox, ainsi que le code source complet. Les versions chargées manuellement ne se mettent pas à jour seules.

  1. 1 Téléchargez le zip Chrome de la dernière version et décompressez-le.
  2. 2 Ouvrez helium://extensions, ou chrome://extensions dans les autres navigateurs, et activez le Mode développeur.
  3. 3 Cliquez sur Charger l'extension non empaquetée et sélectionnez le dossier décompressé.
Ouvrir la dernière version

Épinglez dragoman à la barre d'outils pour l'avoir à portée de clic.

Chrome pour Android ne prend pas en charge les extensions. Sur Android, utilisez Firefox.

Traduisez votre première page

Ouvrez un site web, cliquez sur l'icône dragoman, choisissez une langue puis Traduire la page. Alt+Shift+T, ou Option+Shift+T sur Mac, fait de même au clavier. Les brouillons apparaissent soulignés de pointillés dorés, qui disparaissent à mesure que votre modèle affine chaque paragraphe.

AltShiftT / ⌥⇧T Traduire la page ou afficher l'original

À quoi ressemble une page traduite

Traduit sur votre appareil
Mochi est actuellement promu à rédacteur en chef.
Affiné par le modèle de votre choix
Mochi a depuis été promu rédacteur en chef.
L'original, d'un simple survol
Posez le pointeur sur un paragraphe pour lire le texte d'origine. Un clic sur le badge, ou Alt+Shift+T, rétablit toute la page.

Sur téléphone ou tablette, ouvrez dragoman depuis le menu des extensions de votre navigateur.

Comparé au traducteur de votre navigateur

Chrome, Edge, Safari et Firefox savent traduire les pages eux-mêmes, et pour un coup d'œil, c'est souvent suffisant. dragoman sert quand vous voulez vraiment lire une page : il restitue le sens comme la formulation, et c'est vous qui décidez qui voit le texte.

Il lit la page entière

Les traducteurs intégrés traitent une page par petits morceaux, chacun isolément : un même mot peut donc être traduit de deux façons à quelques lignes d'écart. dragoman montre à votre modèle d'IA le titre de la page, ses intertitres et les expressions qui reviennent, pour qu'un nom, un libellé ou un terme garde la même traduction du début à la fin.

Morceau par morceau

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

Avec toute la page en vue

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Term
Περίοδος
1928–1932
Term
Περίοδος
1933
Term
Une illustration : une même étiquette grecque, répétée dans une infobox, traduite en anglais.

Vous décidez où va le texte

Quand Chrome ou Edge traduit une page, le texte part chez Google ou Microsoft. dragoman rédige un premier jet sur votre appareil, puis n'envoie que ce que vous lisez au fournisseur de votre choix, avec votre propre clé. Restez sur l'appareil, et aucun texte de la page ne sort.

Où va le texte de la page

Chrome Google Edge Microsoft dragoman Votre appareil Votre fournisseur d'IA seulement ce que vous lisez, si vous ajoutez un modèle
Vous choisissez le traducteur
Chrome traduit les pages avec Google Traduction, et Edge avec Microsoft Translator. dragoman fonctionne avec le modèle d'IA de votre choix : Claude, Gemini, les modèles derrière ChatGPT, ou un modèle qui tourne sur votre propre ordinateur. Les modèles d'IA actuels gèrent généralement mieux les expressions, le ton et les mots dont le sens dépend de la phrase.
L'original reste à portée
Survolez un paragraphe, ou touchez-le sur un téléphone, pour lire le texte d'origine, sans rebasculer toute la page.

Le traducteur de votre navigateur est intégré, gratuit et ne demande aucune configuration. Les premiers jets de dragoman sur l'appareil sont gratuits eux aussi, et l'affinage ne coûte que ce que votre fournisseur facture pour le texte que vous lisez, généralement très peu avec un petit modèle. Le traducteur de Firefox utilise Bergamot, le même moteur que dragoman dans Firefox : la différence tient donc au passage par l'IA et au contexte de la page.

Sous le capot
Deux passes
Le modèle local de votre navigateur rédige le premier jet en arrière-plan, et Bergamot, compilé en WebAssembly, prend le relais là où il n'y en a pas. Les paragraphes à l'écran et ceux qui suivent sont ensuite envoyés à votre modèle par petits lots, et chaque paragraphe affiné remplace son premier jet.
Contexte de la page
Chaque requête transmet le titre de la page, le plan de ses intertitres, les expressions récurrentes avec le texte qui entoure leur première apparition, et toutes les traductions déjà retenues. Le modèle renvoie les termes choisis, et les requêtes suivantes s'y tiennent.
Balisage
Les liens, l'emphase et les autres éléments en ligne voyagent sous forme d'espaces réservés numérotés : la mise en page et les liens reviennent intacts.
Seulement ce que vous lisez
L'affinage suit la zone visible : une longue page ne coûte que la partie que vous faites défiler. Les traductions terminées sont enregistrées sur votre appareil et réutilisées à votre retour.
Sans intermédiaire
Les requêtes vont directement de votre navigateur à votre fournisseur, avec votre clé. Il n'y a aucun serveur dragoman, et tout le code est public.

Traduction sur l'appareil

Chaque page commence sur votre appareil. dragoman rédige un premier jet avec le modèle local intégré à Chrome et Edge, et avec celui d'Apple dans Safari. Ces modèles tournent sur votre ordinateur, contrairement à la traduction de pages des navigateurs, qui passe par internet. Partout ailleurs, et pour les langues qu'ils ne couvrent pas, Bergamot, le moteur libre de Firefox Translations, traduit directement dans votre navigateur. Rien de tout cela ne demande de compte ni de clé. Seul, il vous offre une traduction rapide et privée. Avec un modèle d'IA, ces jets deviennent une première version que votre modèle peaufine.

Téléchargement unique par paire de langues

  • anglais → turc 15 Mo
  • anglais → allemand 26 Mo
  • français → anglais 26 Mo
  • japonais → anglais 49 Mo

français → anglais → allemand

52 Mo

Pas de modèle direct entre deux langues ? dragoman passe par l'anglais et télécharge les deux moitiés.

Tailles de téléchargement indiquées dans le registre de modèles de Mozilla.
Langues
Plus de 50 langues, depuis et vers l'anglais. Entre deux autres langues, dragoman passe par l'anglais. Dans la liste des langues, celles marquées IA uniquement nécessitent un modèle d'IA.
Première utilisation
Chrome et Edge téléchargent leurs packs de langues la première fois que vous en avez besoin, et Safari utilise les langues téléchargées pour la traduction d'Apple sur votre appareil. Les paires de langues de Bergamot se téléchargent une seule fois depuis Mozilla, généralement entre 15 et 50 Mo, et restent dans votre navigateur. Ensuite, tout fonctionne hors connexion.
Brouillons et affinage
Les brouillons sont rapides et plutôt littéraux, parfaits pour saisir l'essentiel. Votre modèle les réécrit en tenant compte de toute la page : le texte se lit naturellement, et les noms et termes restent cohérents.
À vous de choisir
Pour garder une page sur votre appareil même avec un modèle configuré, activez Sur cet appareil uniquement dans la fenêtre contextuelle. Pour vous passer des brouillons et attendre votre modèle, désactivez Traduire d'abord sur cet appareil dans les Paramètres.

Bergamot est issu d'un projet de recherche financé par l'Union européenne, et Mozilla entraîne et publie les modèles de langue qu'il utilise. À propos de Bergamot

Ajouter un modèle d'IA

Ouvrez les Paramètres depuis la fenêtre contextuelle, choisissez un fournisseur et suivez les trois étapes. dragoman vérifie la clé dès que vous la collez et présélectionne un modèle rapide et économique, modifiable à tout moment.

Fournisseurs disponibles

  • Anthropic
  • OpenAI
  • Google Gemini
  • OpenRouter
  • Mistral
  • DeepSeek
  • Groq
  • xAI
  • Ollama
  • LM Studio
  • Tout serveur compatible OpenAI

OpenRouter peut créer une clé pour vous. Choisissez Se connecter avec OpenRouter et approuvez la demande.

Les clés Anthropic non liées à un espace de travail nécessitent aussi un ID d'espace de travail. Vous le trouverez dans l'Anthropic Console, sous Settings puis Workspaces.

Utiliser un modèle local

Installez Ollama, téléchargez un modèle comme gemma3, puis lancez-le avec OLLAMA_ORIGINS défini pour qu'il accepte les requêtes de l'extension :

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

Dans LM Studio, chargez un modèle, activez CORS dans les paramètres du serveur et démarrez le serveur local. dragoman le trouve à localhost:1234.

Combien ça coûte

dragoman est gratuit. L'affinage utilise votre propre clé : c'est donc le fournisseur qui vous facture directement. De petits modèles rapides suffisent généralement pour traduire. L'onglet Utilisation des Paramètres compte les tokens par modèle chaque mois, et l'option Afficher le coût de chaque page indique le coût de la page en cours à côté du badge.

4 paragraphes sur 14 affinés

  • Affiné
  • Ébauché
  • Pas encore

Pendant que vous faites défiler, les paragraphes juste après reçoivent une ébauche rapide et ceux à l'écran sont affinés. Le reste de la page ne coûte rien tant que vous n'y êtes pas.

Confidentialité

Ce qui quitte votre ordinateur : les paragraphes à l'écran et ceux qui suivent, ainsi que tout texte que vous demandez à votre compagnon de traduire, envoyés au fournisseur choisi, et, pour les langues que votre navigateur ne sait pas traduire seul, un téléchargement unique de modèle depuis Mozilla. Votre clé n'est envoyée qu'à son propre fournisseur. dragoman n'a ni serveur, ni compte, ni statistiques.

Lire la politique de confidentialité complète

Dépannage

La fenêtre indique que la page ne peut pas être traduite

Les pages du navigateur, comme les paramètres, la page des extensions et les boutiques en ligne, ne permettent pas aux extensions de les modifier. Ouvrez plutôt un site web classique.

Le moteur local n'a pas de modèle pour cette paire

Les traducteurs sur l'appareil couvrent les langues les plus répandues. Dans Safari, vous pouvez en ajouter d'autres sous Langues de traduction, dans les réglages Langue et région de votre appareil. Pour les autres, ajoutez un modèle d'IA et dragoman traduira directement avec lui.

Mon navigateur propose aussi de traduire la page

dragoman demande à votre navigateur de rester en retrait sur les pages qu'il pourrait traduire. Si vous avez désactivé cette option, activez Écarter le traducteur de mon navigateur dans les Paramètres, sous Langues. Si votre navigateur a déjà traduit une page, choisissez Utiliser dragoman à la place pour la recharger dans sa version originale.

Un modèle local ne se connecte pas

Vérifiez que le serveur est lancé et que son adresse correspond à celle des Paramètres. Ollama nécessite OLLAMA_ORIGINS, et LM Studio exige que CORS soit activé.

dragoman ne peut pas lire la page

Safari et Firefox vous laissent choisir les sites web qu'une extension peut lire. Ouvrez dragoman et choisissez Autoriser sur tous les sites.

Firefox n'affine pas avec mon modèle

Firefox demande votre accord avant qu'une extension envoie le texte d'une page. Ouvrez les Paramètres et choisissez Autoriser l'envoi du texte de la page sous votre modèle.

Compiler depuis les sources

dragoman est open source sous licence MIT. Pour le compiler, il vous faut Node 24 et pnpm.

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

Chaque navigateur a sa propre version. Lancez ces commandes depuis extension/ :

Navigateurs Chromium pnpm build → .output/chrome-mv3
Firefox pnpm build:firefox → .output/firefox-mv3
Safari pnpm build:safari → .output/safari-mv3 Compilez ensuite safari/dragoman.xcodeproj dans Xcode.

Le dépôt est un workspace pnpm :

extension/
L'extension, construite avec WXT et Svelte
site/
Ce site web, construit avec SvelteKit
brand/
Les drogmans, le logo et la ville
messages/
Les textes de l'interface en 85 langues