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
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 Free usage quota is available; please refer to the FAQ section on the page for details. (recommended)
Note that the computing resources of the demo are limited, so please avoid abusing them.
Installation and Usage
Installation
- Windows EXE Recommand for Windows
- Docker Recommand for Linux
- uv (a Python package manager) Recommand for macOS
Usage
- Using WebUI
- Using Zotero Plugin (Third party program)
- 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
-
SiliconFlow provides a free translation service for this project, powered by large language models (LLMs).
-
1.x version: Byaidu/PDFMathTranslate
-
backend: BabelDOC
-
PDF Library: PyMuPDF
-
PDF Parsing: Pdfminer.six
-
PDF Preview: Gradio PDF
-
Layout Parsing: DocLayout-YOLO
-
PDF Standards: PDF Explained, PDF Cheat Sheets
-
Multilingual Font: see BabelDOC-Assets
-
Documentation i18n using Weblate
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
Metadata
Release files for pdf2zh-next 2.7.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pdf2zh_next-2.7.1.tar.gz | 7.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pdf2zh_next-2.7.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 7.2 MB
Release files / pdf2zh_next-2.7.1.tar.gz
| Download URL | pdf2zh_next-2.7.1.tar.gz |
|---|---|
| Size | 7.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9a83660febe0698ffebbe171f71d3044aac82f8c0db222f46420f56083b7f472
|
|
BLAKE2b-256 checksum How to use checksums |
e0332c43bdb2267e637bf02fe2610deb7723ef9e4b86160a1d4f7d8ed92140a5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 20, 2025.
Transparency logRelease files / pdf2zh_next-2.7.1-py3-none-any.whl
| Download URL | pdf2zh_next-2.7.1-py3-none-any.whl |
|---|---|
| Size | 134.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b19319e7575ba0dcac079e0658a8c75e9fca9539eacbd239fc72eb6c59b93198
|
|
BLAKE2b-256 checksum How to use checksums |
be151c9f8dcfa2015cac6ad9ad83a64fecce730461ed46673c0a05afbd4d4fcc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 20, 2025.
Transparency log