AIBit-Descubre proyectos de código abierto AIBit-Descubre proyectos de código abierto

BabelDOC: Traductor de PDF de código abierto diseñado para documentos impulsados por IA

BabelDOC es un traductor de PDF totalmente de código abierto que convierte documentos complejos y multilingües en versiones localizadas mediante IA. Con una sencilla CLI en Python, archivos de configuración ricos y la generación opcional de activos offline, potencia todo, desde investigación académica hasta contratos comerciales. Ya seas un desarrollador que busca integrar la traducción en una aplicación más amplia o un usuario que necesita una solución rápida de “copiar y pegar”, BabelDOC gestiona pares de idiomas como inglés‑chino y otros, soporta la preservación del diseño del PDF y ofrece banderas avanzadas para OCR, salida de doble página y uso de glosario. Esta guía te lleva paso a paso a través de la instalación, el uso principal, la integración con herramientas como Zotero y la optimización avanzada del rendimiento, ayudándote a sacar el máximo provecho de tu flujo de trabajo de documentos impulsado por IA.

BabelDOC – El traductor de PDF de código abierto impulsado por IA

En la era de la investigación global y la expansión empresarial rápida, la capacidad de traducir documentos PDF complejos preservando el diseño y formato se ha vuelto esencial. Las herramientas basadas en OCR tradicionales suelen segmentar el texto, romper tablas o perder el formato, dejando a los traductores con mucho trabajo de limpieza manual. Conoce BabelDOC, un proyecto impulsado por la comunidad que convierte la traducción potenciada por IA en un flujo de trabajo único e integrado.

¿Qué es BabelDOC?

BabelDOC es un Otro Traductor de Documentos escrito en Python. Acepta un PDF, extrae el texto con analizadores de diseño de última generación, alimenta las oraciones a un LLM (compatible con OpenAI por defecto) y vuelve a ensamblar el texto traducido en un nuevo PDF que replica el diseño original.

Características principales:

  • Salida de doble página: páginas originales y traducidas lado a lado, o en orden alternado.
  • Soporte de texto enriquecido: fórmulas, tablas y formatos complejos se mantienen intactos.
  • Generación de activos offline: crea un ZIP con fuentes y pesos de modelos para entornos sin conexión.
  • CLI y API de Python extensibles: fácil integración en scripts o aplicaciones más grandes.
  • Soporte de glosarios: mantiene la terminología consistente entre documentos.

Empezando – Instalación

BabelDOC se puede instalar de dos maneras:

  1. PyPI + UV (recomendado)

    uv tool install --python 3.12 BabelDOC
babeldoc --help

    UV resuelve automáticamente las dependencias y coloca el binario babeldoc en tu PATH.

  2. Desde el código fuente (para desarrolladores)

    git clone https://github.com/funstory-ai/BabelDOC
cd BabelDOC
uv run babeldoc --help

    El comando uv run configura un entorno virtual nuevo y ejecuta BabelDOC directamente.

Uso básico

Traducir un único PDF de inglés a chino:

babeldoc --openai --openai-model "gpt-4o-mini" \
  --openai-base-url "https://api.openai.com/v1" \
  --openai-api-key "YOUR_KEY" \
  --files example.pdf

Para múltiples documentos, simplemente repite la bandera --files:

babeldoc --files paper1.pdf --files paper2.pdf --openai ...

La salida aparece en la misma carpeta a menos que proporciones --output /path/to/dir.

Opciones avanzadas

La CLI de BabelDOC está cargada de banderas que te brindan control preciso:

  • --disable-rich-text-translate – Omite el texto enriquecido para mayor compatibilidad.
  • --watermark-output-mode – Elige entre marca de agua, sin marca o ambos.
  • --max-pages-per-part – Divide PDFs grandes en fragmentos manejables.
  • --openai-model – Sustituye con cualquier LLM compatible con OpenAI, como glm‑4‑flash o deepseek‑chat.
  • --glossary-files – Carga listas de términos CSV para forzar traducciones consistentes.

Estas opciones son ideales para pipelines de producción donde velocidad, tamaño y consistencia son clave.

Empaquetado de activos offline

Si trabajas en un entorno sin acceso a la red, BabelDOC puede generar un paquete de activos auto-contenido:

babeldoc --generate-offline-assets ./offline_assets

Más tarde, lo restauras en otra máquina:

babeldoc --restore-offline-assets ./offline_assets/package.zip

Integración con Zotero

Los investigadores académicos suelen almacenar PDFs en Zotero. BabelDOC admite integración directa mediante el plugin Immersive Translate (para miembros Pro) y el wrapper pdf2zh‑next (para usuarios autoimplementados).

Estos complementos traducen automáticamente los PDFs al descargarlos o cuando presionas un ítem de menú contextual, añadiendo versiones traducidas a tu biblioteca.

Auto-implementación con PDFMathTranslate

Para usuarios que deseen control total sobre la pila del servidor, BabelDOC se puede integrar en PDFMathTranslate‑next. La aplicación resultante incluye una interfaz web, colas por lotes y una API RESTful.

Hoja de ruta y comunidad

El proyecto se mantiene activamente, con más de 200 versiones y más de 6 k estrellas. Las próximas metas incluyen:

  • Soporte nativo de líneas
  • Manejo extensivo de tablas
  • Soporte de iniciales mayúsculas
  • Fusión de párrafos entre páginas
  • Detección mejorada de OCR para PDFs escaneados

Los colaboradores son bienvenidos vía pull requests. La calidad del código se mantiene mediante hooks pre‑commit, pruebas automatizadas e integración continua.

TL;DR

BabelDOC ofrece:

  • Traducción de PDF de un solo punto con IA
  • Control total sobre el formato de salida
  • CLI y API de Python para automatización
  • Soporte de activos offline para entornos sin conexión
  • Desarrollo impulsado por la comunidad y hoja de ruta robusta

Ya sea que estés traduciendo artículos de investigación, manuales técnicos o contratos comerciales, BabelDOC ofrece la flexibilidad y potencia para mantener el diseño original mientras se localiza el contenido a la velocidad de la IA.

Pruébalo hoy y transforma la forma en que manejas PDFs multilingües.