pdf2zh-next

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 🌟

[!NOTE]

pdf2zh 2.0 does not currently provide an online demo

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

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 programm)
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)

[!NOTE]

Currently, no relevant documentation is provided. It will be supplemented later. Please wait patiently.

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

Alt

Star History

Metadata

Release files for pdf2zh-next 2.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pdf2zh-next 2.1.2
File	Size	Uploaded
pdf2zh_next-2.1.2.tar.gz	5.0 MB	Jun 18, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for pdf2zh-next 2.1.2
File	Interpreter	ABI	Platform	Reset
pdf2zh_next-2.1.2-py3-none-any.whl 73.6 kB Jun 18, 2025	Python 3	none	any	Details

Total release size: 5.1 MB

Release files / pdf2zh_next-2.1.2.tar.gz

Download URL	pdf2zh_next-2.1.2.tar.gz
Size	5.0 MB
Tags	Source
SHA-256 checksum How to use checksums	`43e39612f7171ccb1e85879882c6e930b9f7031be5de115a47eaf78fe949b99d`
BLAKE2b-256 checksum How to use checksums	`afbcc5d84ba4b836d23767625fc1bdde5f15fd01e7a71ab9bd0cbaf21ed0d242`
Upload date	Jun 18, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.9`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/PDFMathTranslate/PDFMathTranslate-next
Publishing commit: github.com/PDFMathTranslate/PDFMathTranslate-next/tree/ee62ee0d0d1fb45a135a26a090647ae9ed7e0081

Workflow

Publishing configuration: github.com/PDFMathTranslate/PDFMathTranslate-next/blob/ee62ee0d0d1fb45a135a26a090647ae9ed7e0081/.github/workflows/release.yml
Publishing logs: github.com/PDFMathTranslate/PDFMathTranslate-next/actions/runs/15729515107/attempts/1

Artifact

Subject: pdf2zh_next-2.1.2.tar.gz
SHA-256 checksum: 43e39612f7171ccb1e85879882c6e930b9f7031be5de115a47eaf78fe949b99d Verifying attestations

Release files / pdf2zh_next-2.1.2-py3-none-any.whl

Download URL	pdf2zh_next-2.1.2-py3-none-any.whl
Size	73.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`fec530550d4999bef02cfcd65c8f3dc57b4fa0a69fd43553ad29339cd56bd5fb`
BLAKE2b-256 checksum How to use checksums	`151512b23ee1adad7c3532304c0c6fe9aeea54e1247a4eb2959b1bedfdcfca35`
Upload date	Jun 18, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/PDFMathTranslate/PDFMathTranslate-next
Publishing commit: github.com/PDFMathTranslate/PDFMathTranslate-next/tree/ee62ee0d0d1fb45a135a26a090647ae9ed7e0081

Workflow

Publishing configuration: github.com/PDFMathTranslate/PDFMathTranslate-next/blob/ee62ee0d0d1fb45a135a26a090647ae9ed7e0081/.github/workflows/release.yml
Publishing logs: github.com/PDFMathTranslate/PDFMathTranslate-next/actions/runs/15729515107/attempts/1

Artifact

Subject: pdf2zh_next-2.1.2-py3-none-any.whl
SHA-256 checksum: fec530550d4999bef02cfcd65c8f3dc57b4fa0a69fd43553ad29339cd56bd5fb Verifying attestations