Saltar al contenido

Documentación

Todo lo que necesitas para instalar dragoman, conectar un modelo y mantenerlo en marcha.

Instalación

Instala dragoman desde la tienda de tu navegador y se mantendrá actualizado automáticamente.

Chrome, Edge, Helium y otros navegadores Chromium
Instalar una versión a mano

Cada versión está también en GitHub, con archivos zip para navegadores Chromium y Firefox, además del código fuente completo. Las versiones cargadas a mano no se actualizan solas.

  1. 1 Descarga el zip de Chrome de la última versión y descomprímelo.
  2. 2 Abre helium://extensions, o chrome://extensions en otros navegadores, y activa el Modo de desarrollador.
  3. 3 Elige Cargar descomprimida y selecciona la carpeta descomprimida.
Abrir la última versión

Fija dragoman en la barra de herramientas para tenerlo a un clic.

Chrome para Android no admite extensiones. En Android, usa Firefox.

Traduce tu primera página

Abre cualquier sitio web, haz clic en el icono de dragoman, elige un idioma y pulsa Traducir página. Alt+Shift+T, u Option+Shift+T en Mac, hace lo mismo desde el teclado. Los borradores aparecen con un subrayado dorado punteado, que desaparece a medida que tu modelo pule cada párrafo.

AltShiftT / ⌥⇧T Traducir la página o mostrar el original

Cómo se lee una página traducida

Borrador en tu dispositivo
Mochi está actualmente promovido a editor en jefe.
Pulido por el modelo que elijas
Desde entonces, Mochi ha ascendido a redactor jefe.
El original, con solo pasar el cursor
Apoya el puntero en cualquier párrafo para leer lo que decía antes. Un clic en la insignia, o Alt+Shift+T, restaura toda la página.

En un móvil o tableta, abre dragoman desde el menú de extensiones del navegador.

Frente al traductor de tu navegador

Chrome, Edge, Safari y Firefox pueden traducir páginas por sí solos, y para echar un vistazo suele bastar. dragoman es para cuando quieres leer una página de verdad: acierta con el sentido y con las palabras, y tú decides quién ve el texto.

Lee la página entera

Los traductores integrados recorren la página en trozos pequeños, cada uno por separado, así que la misma palabra puede salir de dos maneras con pocas líneas de diferencia. dragoman muestra a tu modelo de IA el título de la página, sus encabezados y las frases que se repiten, para que un nombre, una etiqueta o un término mantenga una sola traducción de principio a fin.

Fragmento a fragmento

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

Con toda la página a la vista

Περίοδος
1910–1915
Term
Περίοδος
1917–1920
Term
Περίοδος
1928–1932
Term
Περίοδος
1933
Term
Un ejemplo: una misma etiqueta en griego, repetida a lo largo de una ficha, traducida al inglés.

Tú decides adónde va el texto

Cuando Chrome o Edge traducen una página, envían el texto a Google o Microsoft. dragoman hace un borrador en tu dispositivo y luego envía solo lo que estás leyendo al proveedor que elegiste, con tu propia clave. Si lo dejas en el dispositivo, ningún texto de la página sale de él.

Adónde va el texto de la página

Chrome Google Edge Microsoft dragoman Tu dispositivo Tu proveedor de IA solo lo que lees, si añades un modelo
Tú eliges el traductor
Chrome traduce las páginas con Google Translate, y Edge con Microsoft Translator. dragoman funciona con el modelo de IA que elijas: Claude, Gemini, los modelos de ChatGPT o uno que se ejecute en tu propio ordenador. Los modelos de IA actuales suelen manejar mejor las expresiones, el tono y las palabras cuyo significado depende de la frase.
El original, siempre a mano
Pasa el cursor por cualquier párrafo, o tócalo en el móvil, para leer lo que decía antes, sin devolver toda la página al original.

El traductor de tu navegador viene integrado, es gratis y no requiere configuración. Los borradores locales de dragoman también son gratis, y el pulido solo cuesta lo que tu proveedor cobre por el texto que lees, normalmente muy poco con un modelo pequeño. El traductor propio de Firefox usa Bergamot, el mismo motor con el que dragoman hace borradores en Firefox, así que ahí la diferencia está en la pasada de IA y el contexto de la página.

Cómo funciona por dentro
Dos pasadas
El modelo del dispositivo de tu navegador hace el borrador en segundo plano, y Bergamot, compilado a WebAssembly, cubre los casos en que no lo hay. Después, los párrafos en pantalla y los siguientes van a tu modelo en pequeños lotes, y cada párrafo pulido sustituye a su borrador.
Contexto de la página
Cada solicitud incluye el título de la página, un esquema de sus encabezados, las frases que se repiten en ella con el texto que rodea su primera aparición y todas las traducciones fijadas hasta el momento. El modelo devuelve los términos que eligió y las solicitudes siguientes los respetan.
Marcado
Los enlaces, el énfasis y otros elementos en línea viajan como marcadores numerados, así que el diseño y los enlaces vuelven intactos.
Solo lo que lees
El pulido sigue a lo que tienes en pantalla, así que una página larga solo cuesta la parte que recorres. Las traducciones terminadas se guardan en tu dispositivo y se reutilizan cuando vuelves.
Sin intermediarios
Las solicitudes van directamente de tu navegador a tu proveedor con tu clave. No hay ningún servidor de dragoman y todo el código es público.

Traducción en el dispositivo

Cada página empieza en tu dispositivo. dragoman hace el borrador con el modelo integrado en Chrome y Edge, y con el de Apple en Safari. Estos se ejecutan en tu ordenador, a diferencia de la traducción de páginas de los propios navegadores, que funciona en línea. En cualquier otro caso, y para los idiomas que esos no cubren, Bergamot, el motor abierto de Firefox Translations, hace el borrador dentro de tu navegador. Nada de esto requiere cuenta ni clave. Por sí solo, te da una traducción rápida y privada. Con un modelo de IA, esos borradores son una primera versión que tu modelo pule.

Una sola descarga por par de idiomas

  • inglés → turco 15 MB
  • inglés → alemán 26 MB
  • francés → inglés 26 MB
  • japonés → inglés 49 MB

francés → inglés → alemán

52 MB

¿No hay un modelo directo entre dos idiomas? dragoman pasa por el inglés y descarga ambas mitades.

Tamaños de descarga según el registro de modelos de Mozilla.
Idiomas
Más de 50 idiomas, desde y hacia el inglés. Entre otros dos idiomas, dragoman pasa por el inglés. En la lista de idiomas, los marcados con Solo IA necesitan un modelo de IA.
Primer uso
Chrome y Edge descargan sus paquetes de idioma la primera vez que los necesitas, y Safari usa los idiomas descargados para la traducción de Apple en tu dispositivo. Los pares de idiomas de Bergamot se descargan una vez de Mozilla, normalmente entre 15 y 50 MB, y se quedan en tu navegador. A partir de ahí, todo funciona sin conexión.
Borradores y pulido
Los borradores son rápidos y bastante literales, ideales para captar la idea general. Tu modelo los reescribe teniendo en cuenta toda la página, para que el texto suene natural y los nombres y términos se mantengan coherentes.
Tú decides
Para mantener una página en tu dispositivo aunque tengas un modelo configurado, activa Solo en este dispositivo en la ventana emergente. Para saltarte los borradores y esperar a tu modelo, desactiva Hacer primero un borrador en este dispositivo en Ajustes.

Bergamot nació de un proyecto de investigación financiado por la Unión Europea, y Mozilla entrena y publica los modelos de idioma que utiliza. Acerca de Bergamot

Añade un modelo de IA

Abre Ajustes desde la ventana emergente, elige un proveedor y sigue los tres pasos. dragoman comprueba la clave en cuanto la pegas y preselecciona un modelo rápido y económico, que puedes cambiar cuando quieras.

Proveedores que puedes usar

  • Anthropic
  • OpenAI
  • Google Gemini
  • OpenRouter
  • Mistral
  • DeepSeek
  • Groq
  • xAI
  • Ollama
  • LM Studio
  • Cualquier servidor compatible con OpenAI

OpenRouter puede crear una clave por ti. Elige Conectar con OpenRouter y aprueba la solicitud.

Las claves de Anthropic que no están vinculadas a un espacio de trabajo también necesitan un ID de espacio de trabajo. Lo encontrarás en Anthropic Console, en Settings y después Workspaces.

Usa un modelo local

Instala Ollama, descarga un modelo como gemma3 e inícialo con OLLAMA_ORIGINS configurado para que acepte solicitudes de la extensión:

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

En LM Studio, carga un modelo, activa CORS en los ajustes del servidor e inicia el servidor local. dragoman lo encuentra en localhost:1234.

Cuánto cuesta

dragoman es gratis. El pulido funciona con tu propia clave, así que el proveedor te factura directamente. Para traducir, suelen bastar modelos pequeños y rápidos. La pestaña Uso de Ajustes cuenta los tokens de cada modelo por mes y, si activas Mostrar el coste de cada página, verás el coste de la página actual junto a la insignia.

4 de 14 párrafos pulidos

  • Pulido
  • Borrador
  • Aún no

Mientras te desplazas, los párrafos que vienen reciben un borrador rápido y los que están en pantalla se pulen. El resto de la página no cuesta nada hasta que llegas a él.

Privacidad

Lo que sale de tu ordenador: los párrafos en pantalla y los siguientes, más cualquier texto que pidas traducir a tu acompañante, enviados al proveedor que elegiste, y, para idiomas que tu navegador no traduce por sí solo, una descarga única de un modelo desde Mozilla. Tu clave solo se envía a su propio proveedor. dragoman no tiene servidor, ni cuenta, ni analíticas.

Leer la política de privacidad completa

Solución de problemas

La ventana emergente dice que la página no se puede traducir

Las páginas del navegador, como los ajustes, la página de extensiones y las tiendas web, no permiten que las extensiones las modifiquen. Abre un sitio web normal.

El motor del dispositivo no tiene modelo para este par

Los traductores locales cubren los idiomas más usados. En Safari puedes añadir más en Idiomas de traducción, dentro de los ajustes de Idioma y región de tu dispositivo. Para el resto, añade un modelo de IA y dragoman traducirá directamente con él.

Mi navegador también se ofrece a traducir la página

dragoman pide a tu navegador que no intervenga en las páginas que podría traducir. Si lo desactivaste, activa Apartar el traductor de mi navegador en Ajustes, en Idiomas. Si tu navegador ya tradujo una página, elige Usar dragoman en su lugar para recargarla en el original.

Un modelo local no se conecta

Comprueba que el servidor está en marcha y que su dirección en Ajustes coincide. Ollama necesita OLLAMA_ORIGINS y LM Studio necesita CORS activado.

dragoman no puede leer la página

Safari y Firefox te dejan elegir qué sitios web puede leer una extensión. Abre dragoman y elige Permitir en todos los sitios web.

Firefox no pule con mi modelo

Firefox pregunta antes de que una extensión envíe el texto de una página a cualquier sitio. Abre Ajustes y elige Permitir enviar el texto de la página, debajo de tu modelo.

Compilar desde el código fuente

dragoman es de código abierto con licencia MIT. Para compilarlo necesitas Node 24 y pnpm.

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

Cada navegador tiene su propia compilación. Ejecuta esto desde extension/:

Navegadores Chromium pnpm build → .output/chrome-mv3
Firefox pnpm build:firefox → .output/firefox-mv3
Safari pnpm build:safari → .output/safari-mv3 Después compila safari/dragoman.xcodeproj en Xcode.

El repositorio es un workspace de pnpm:

extension/
La extensión, hecha con WXT y Svelte
site/
Este sitio web, hecho con SvelteKit
brand/
Los dragomanes, el logotipo y la ciudad
messages/
Textos de la interfaz en 85 idiomas