Azure/co-op-translator

Easily automate the translation of your documentation into multiple languages, powered by Azure AI Services

What it solves

Co-op Translator addresses the difficulty of keeping large-scale, multilingual GitHub documentation repositories synchronized. It prevents translations from becoming stale when source content changes and ensures that complex structures—including relative links, Jupyter notebooks, and image text—remain intact and functional across different language versions.

How it works

The tool treats translations as versioned software artifacts by using language-scoped metadata and source hashes to identify exactly which files need updating, skipping unchanged content to save costs and time. It processes content through a four-step pipeline:

  1. Plan: Scans the repository to find new or outdated content.
  2. Translate: Uses providers like Azure OpenAI or OpenAI to translate Markdown, notebook cells, and image text (via Azure AI Vision).
  3. Preserve: Protects code blocks and URL destinations while rewriting relative paths to match the translated folder structure.
  4. Track: Saves metadata to enable incremental updates and structural reviews.

Who it’s for

It is designed for maintainers of open-source projects and technical documentation who manage multilingual repositories containing a mix of prose, code samples, and interactive notebooks.

Highlights

  • Incremental Updates: Only translates changed content based on source hashes.
  • Multi-format Support: Handles Markdown, Jupyter notebooks, and text within images.
  • Structural Integrity: Automatically rewrites relative links and protects code blocks from being altered by AI models.
  • presentable Interfaces: Available via CLI, Python API, GitHub Actions, containers, and as an MCP server for agentic workflows.
  • Deterministic Review: Includes tools to verify translation freshness and link validity.

Related

  • Project
  • Project
  • Project
  • Project
  • Project