Deploy PDFMathTranslate to your favorite cloud provider

Logo PDFMathTranslate

PDFMathTranslate

PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译,支持 Google/DeepL/Ollama/OpenAI 等服务,提供 CLI/GUI/MCP/Docker/Zotero

PDF scientific paper translation and bilingual comparison.

  • 📊 Preserve formulas, charts, table of contents, and annotations (preview).

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

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

Updates

BabelDOC@awwaawwa@awwaawwaXinference@imClumsyPanda@reycn@YadominJinta@yidasanqian

Preview

PDFMathTranslate

Online Service 🌟

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

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

Installation and Usage

Methods

For different use cases, we provide distinct methods to use our program:

1. UV install
  1. Python installed (3.10 <= version <= 3.12)
  2. Install our package:
   pip install uv
   uv tool install --python 3.12 pdf2zh
  1. Execute translation, files generated in current working directory:
   pdf2zh document.pdf
2. Windows exe
  1. Download pdf2zh-version-win64.zip from release page
  2. Unzip and double-click pdf2zh.exe to run.
3. Graphic user interface 1. Python installed (3.10 <= version <= 3.12) 2. Install our package:
pip install pdf2zh
  1. Start using in browser:
   pdf2zh -i
  1. If your browswer has not been started automatically, goto
   http://localhost:7860/
PDFMathTranslate

See documentation for GUI for more details.

4. Docker
  1. Pull and run:
   docker pull byaidu/pdf2zh
   docker run -d -p 7860:7860 byaidu/pdf2zh
  1. Open in browser:
    http://localhost:7860/
    

For docker deployment on cloud service:

5. Zotero Plugin

See Zotero PDF2zh for more details.

6. Commandline
  1. Python installed (3.10 <= version <= 3.12)
  2. Install our package:
   pip install pdf2zh
  1. Execute translation, files generated in current working directory:
   pdf2zh document.pdf
Tip
> - If you're using Windows and cannot open the file after downloading, please install vc_redist.x64.exe and try again. > - If you cannot access Docker Hub, please try the image on GitHub Container Registry.
> docker pull ghcr.io/byaidu/pdfmathtranslate
> docker run -d -p 7860:7860 ghcr.io/byaidu/pdfmathtranslate
> ```

##### Unable to install?


The present program needs an AI model(`wybxc/DocLayout-YOLO-DocStructBench-onnx`) before working and some users are not able to download due to network issues. If you have a problem with downloading this model, we provide a workaround using the following environment variable:

```shell
set HF_ENDPOINT=https://hf-mirror.com

For PowerShell user:

$env:HF_ENDPOINT = https://hf-mirror.com

If the solution does not work to you / you encountered other issues, please refer to frequently asked questions.

Advanced Options

Execute the translation command in the command line to generate the translated document example-mono.pdf and the bilingual document example-dual.pdf in the current working directory. Use Google as the default translation service. More support translation services can find HERE.

cmd

In the following table, we list all advanced options for reference:

OptionFunctionExample
filesLocal filespdf2zh ~/local.pdf
linksOnline filespdf2zh <a href="http://arxiv.org/paper.pdf" target="_blank" rel="nofollow">arxiv.org/paper.pdf`
-iEnter GUIpdf2zh -i
-pPartial document translationpdf2zh example.pdf -p 1
-liSource languagepdf2zh example.pdf -li en
-loTarget languagepdf2zh example.pdf -lo zh
-sTranslation servicepdf2zh example.pdf -s deepl
-tMulti-threadspdf2zh example.pdf -t 1
-oOutput dirpdf2zh example.pdf -o output
-f, -cExceptionspdf2zh example.pdf -f "(MS.*)"
-cpCompatibility Modepdf2zh example.pdf --compatible
--skip-subset-fontsSkip font subsetpdf2zh example.pdf --skip-subset-fonts
--ignore-cacheIgnore translate cachepdf2zh example.pdf --ignore-cache
--sharePublic linkpdf2zh -i --share
--authorizedAuthorizationpdf2zh -i --authorized users.txt [auth.html]
--promptCustom Promptpdf2zh --prompt [prompt.txt]
--onnxUse Custom DocLayout-YOLO ONNX modelpdf2zh --onnx [onnx/model/path]
--serverportUse Custom WebUI portpdf2zh --serverport 7860
--dirbatch translatepdf2zh --dir /path/to/translate/
--configconfiguration filepdf2zh --config /path/to/config/config.json
--serverportcustom gradio server portpdf2zh --serverport 7860
--babeldocUse Experimental backend BabelDOC to translatepdf2zh --babeldoc -s openai example.pdf
--mcpEnable MCP STDIO modepdf2zh --mcp
--sseEnable MCP SSE modepdf2zh --mcp --sse

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

Secondary Development (APIs)

For downstream applications, please refer to our document about API Details for futher information about:

  • Python API, how to use the program in other Python programs
  • HTTP API, how to communicate with a server with the program installed

TODOs

PaddleXPaperMageSAM2ZoteroObsidian

Acknowledgements

Immersive TranslationCONTRIBUTOR_REWARD.mdBabelDOCPyMuPDFPdfminer.sixMinerUGradio PDFMathTranslateDocLayout-YOLOPDF ExplainedPDF Cheat SheetsGo Noto Universal

Contributors

PDFMathTranslateAlt

Star History

Star History Chart