Home

PDFMathTranslate

PDF scientific paper translation and bilingual comparison.

• 📊 Preserve formulas, charts, table of contents, and annotations (preview).
• 🌐 Support multiple languages, and diverse translation services.
• 🤖 Provides commandline tool, interactive user interface, and Docker

Feel free to provide feedback in GitHub Issues or Telegram Group.

For details on how to contribute, please consult the Contribution Guide.

Updates

• [Jun. 4, 2025] The project is renamed and move to PDFMathTranslate/PDFMathTranslate-next (by @awwaawwa)
• [Mar. 3, 2025] Experimental support for the new backend BabelDOC WebUI added as an experimental option (by @awwaawwa)
• [Feb. 22 2025] Better release CI and well-packaged windows-amd64 exe (by @awwaawwa)
• [Dec. 24 2024] The translator now supports local models on Xinference (by @imClumsyPanda)
• [Dec. 19 2024] Non-PDF/A documents are now supported using -cp (by @reycn)
• [Dec. 13 2024] Additional support for backend by (by @YadominJinta)
• [Dec. 10 2024] The translator now supports OpenAI models on Azure (by @yidasanqian)

Preview

Online Service 🌟

You can try our application out using either of the following demos:

• v1.x Public free service online without installation (recommended).
• Immersive Translate - BabelDOC 1000 free pages per month. (recommended)

Note that the computing resources of the demo are limited, so please avoid abusing them.

Installation and Usage

Installation

1. Windows EXE Recommand for Windows
2. Docker Recommand for Linux
3. uv (a Python package manager) Recommand for macOS

Usage

1. Using WebUI
2. Using Zotero Plugin (Third party programm)
3. Using Commandline

For different use cases, we provide distinct methods to use our program. Check out this page for more information.

Advanced Options

For detailed explanations, please refer to our document about Advanced Usage for a full list of each option.

Secondary Development (APIs)

Language Code

If you don't know what code to use to translate to the language you need, check out this documentation

Acknowledgements

• Immersive Translation sponsors monthly Pro membership redemption codes for active contributors to this project, see details at: CONTRIBUTOR_REWARD.md

• 1.x version: Byaidu/PDFMathTranslate

• New backend: BabelDOC

• Document merging: PyMuPDF

• Document parsing: Pdfminer.six

• Document extraction: MinerU

• Document Preview: Gradio PDF

• Multi-threaded translation: MathTranslate

• Layout parsing: DocLayout-YOLO

• Document standard: PDF Explained, PDF Cheat Sheets

• Multilingual Font: Go Noto Universal

• Asynchronize

• Rich logging with multiprocessing

Before submit your code

We welcome the active participation of contributors to make pdf2zh better. Before you are ready to submit your code, please refer to our Code of Conduct and Contribution Guide.

Contributors

Star History