




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.
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.
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.
Proporciona el documento
Proporciona cualquier archivo estructurado. Dragoman detecta automáticamente el formato y el idioma de origen, y analiza la estructura del documento.
La IA traduce los valores
Con OpenAI, dragoman traduce únicamente el contenido de texto. Las claves, atributos, etiquetas y placeholders permanecen completamente intactos.
Recibe la traducción
Obtienes una traducción perfectamente estructurada: la misma forma que el original, lista para añadir a tu proyecto.
{ "greeting": "Hello", "farewell": "Goodbye", "menu": { "home": "Home", "about": "About us", "contact": "Get in touch" } }
{ "greeting": "Hallo", "farewell": "Auf Wiedersehen", "menu": { "home": "Startseite", "about": "Über uns", "contact": "Kontakt aufnehmen" } }
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.
Todos los formatos con los que trabajas
Dragoman admite cualquier formato de documento estructurado utilizado en el desarrollo de software moderno.
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.
XLIFF, cadenas de Android, texto SVG, cargas útiles SOAP — las etiquetas y los atributos permanecen intactos mientras se traducen los nodos de texto.
Configuraciones de Kubernetes, locales de Rails, archivos de contenido de Hugo — la sangría y las anclas se conservan perfectamente.
Traduce desde tu terminal
Un solo comando es suficiente. Usa pipes, redirecciones o escribe directamente en archivos.
# 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 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
Commits
171+
Formatos
JSON, XML, YAML
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.