Dragoman Mascot
こんにちは世界
¡Hola Mundo!
Herramienta de código abierto

dragoman

Traducción impulsada por IA para documentos estructurados. Introduce cualquier formato de archivo y recibe archivos perfectamente traducidos, con todas las claves, etiquetas y placeholders intactos.

MIT · Go ·CLI + Library
Scroll
¿Qué es Dragoman?

Tus documentos, cualquier idioma

D ragoman es una biblioteca Go y una herramienta CLI que traduce documentos estructurados en cualquier formato de archivo con IA, preservando su estructura exacta. Las claves siguen siendo claves, las etiquetas siguen siendo etiquetas y los placeholders no se modifican. Solo se traduce el texto legible, con una comprensión completa del contexto para obtener resultados precisos y naturales.

Tanto si mantienes una aplicación Nuxt con 27 archivos de idioma como si entregas un producto SaaS con configuraciones YAML, dragoman gestiona actualizaciones incrementales, preservación de términos y fragmentación de documentos grandes de forma nativa. Úsalo en la terminal o intégralo directamente en tus aplicaciones Go.

Cómo funciona

Tres pasos hacia cualquier idioma

Sin configuraciones complejas ni archivos de configuración. Muéstrale a dragoman tu documento e indica el idioma de destino.

1

Proporciona el documento

Proporciona cualquier archivo estructurado. Dragoman detecta automáticamente el formato y el idioma de origen, y analiza la estructura del documento.

2

La IA traduce los valores

Con OpenAI, dragoman traduce únicamente el contenido de texto. Las claves, atributos, etiquetas y placeholders permanecen completamente intactos.

3

Recibe la traducción

Obtienes una traducción perfectamente estructurada: la misma forma que el original, lista para añadir a tu proyecto.

en.jsonSource
{
  "greeting": "Hello",
  "farewell": "Goodbye",
  "menu": {
    "home": "Home",
    "about": "About us",
    "contact": "Get in touch"
  }
}
de.jsonTranslated
{
  "greeting": "Hallo",
  "farewell": "Auf Wiedersehen",
  "menu": {
    "home": "Startseite",
    "about": "Über uns",
    "contact": "Kontakt aufnehmen"
  }
}
Características

Creado para flujos de trabajo de traducción reales

Preservación de la estructura

Las claves, etiquetas, anclas, atributos y placeholders de plantillas se conservan exactamente, independientemente del formato. Solo se traducen los valores legibles por humanos.

Compatibilidad multiformato

Funciona de forma nativa con cualquier formato de archivo estructurado. Detecta el formato automáticamente y procesa estructuras anidadas de cualquier profundidad.

Actualizaciones incrementales

Usa el modo de actualización para traducir solo las claves nuevas o faltantes. El contenido ya traducido se omite, lo que ahorra tiempo y costes de API.

Preservación de términos

Mantén sin cambios las marcas, los términos técnicos y las frases específicas durante la traducción con la bandera --preserve.

Detección automática de idioma

El idioma de origen se detecta automáticamente a partir del contenido. Solo debes indicarlo manualmente si así lo deseas explícitamente.

CLI + biblioteca de Go

Usa dragoman en la terminal para traducciones rápidas o impórtalo como paquete de Go e integra la lógica de traducción en tus aplicaciones.

Fragmentación inteligente

Los documentos grandes se dividen automáticamente en fragmentos que caben en la ventana de contexto del modelo de IA y luego se vuelven a unir sin problemas.

IA consciente del contexto

Impulsado por OpenAI — las traducciones comprenden el contexto, el tono y el campo especializado, y ofrecen resultados naturales en lugar de sustituciones palabra por palabra.

Formatos compatibles

Todos los formatos con los que trabajas

Dragoman admite cualquier formato de documento estructurado utilizado en el desarrollo de software moderno.

.json

Archivos de configuración regional i18n, respuestas de API, archivos de configuración — dragoman conserva cada clave y cada estructura anidada durante la traducción.

.xml

XLIFF, cadenas de Android, texto SVG, cargas útiles SOAP — las etiquetas y los atributos permanecen intactos mientras se traducen los nodos de texto.

.yaml

Configuraciones de Kubernetes, locales de Rails, archivos de contenido de Hugo — la sangría y las anclas se conservan perfectamente.

Línea de comandos

Traduce desde tu terminal

Un solo comando es suficiente. Usa pipes, redirecciones o escribe directamente en archivos.

terminal
# Translate a JSON file from English to German
$ dragoman locales/en.json --to de --out locales/de.json

Translating en → de ...
 42 keys translated
 Structure preserved
 Written to locales/de.json

# Only translate new or missing keys
$ dragoman locales/en.json --to de --update locales/de.json

Comparing source with existing translation...
 8 new keys found
 34 keys skipped (already translated)
 Updated locales/de.json

# Preserve specific terms during translation
$ dragoman config.yaml --to ja --preserve "Dragoman,API,OAuth"

Translating en → ja ...
 Terms preserved: Dragoman, API, OAuth
 Written to stdout

Instalación mediante Go

go install github.com/modernice/dragoman/cmd/dragoman@latest
Código abierto

Libre y de código abierto

dragoman tiene licencia MIT y se mantiene activamente. Las contribuciones, los issues y los comentarios son siempre bienvenidos.

Licencia

MIT

Idioma

Go

Commits

171+

Formatos

JSON, XML, YAML

Ver en GitHub

Preguntas frecuentes

Todo lo que necesitas saber sobre dragoman.

Dragoman utiliza la API de OpenAI (modelos GPT) para las traducciones. Necesitas una clave de API de OpenAI como variable de entorno OPENAI_API_KEY.

Sí. Usa la bandera --update para traducir solo las claves nuevas o faltantes en un archivo de traducción existente. El contenido ya traducido se conserva.

Por supuesto. Usa la bandera --preserve seguida de una lista de términos separados por comas. Las marcas, los términos técnicos o cualquier frase permanecerán sin cambios.

Dragoman divide automáticamente los documentos grandes en fragmentos que caben en la ventana de contexto del modelo, traduce cada fragmento y combina el resultado en una única salida.

Sí. Importa github.com/modernice/dragoman y úsalo mediante programación en tus aplicaciones Go. La biblioteca ofrece la misma funcionalidad que la CLI.

Dragoman es gratuito y tiene licencia MIT. Sin embargo, utiliza la API de OpenAI para las traducciones, que tiene su propia tarifa basada en el uso.

Ponte en contacto con nosotros

¿Dudas sobre Dragoman, un formato que falta o un proyecto de traducción propio? Escríbenos o agenda una conversación, te ayudamos con gusto.