logo
Login
Cover image
Pdfmathtranslate
Private

Pdfmathtranslate

Try Now
1 天前

PDF Traduction de papier scientifique avec formats conservés - 基于 AI 完整保留排版的 PDF 文档全文双语翻译 ， 支持 Google / Deepl / Olllama / Openai 等服务 ， 提供 CLI / GUI / MCP / DOCKER / ZOTERO

3 years

Works with Finder

21.5k

Github Watches

1.8k

Github Forks

21.5k

Github Stars

PDF scientific paper translation and bilingual comparison.

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

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

Updates

  • [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:

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

  3. 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

  2. If your browswer has not been started automatically, goto

    http://localhost:7860/

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

  2. 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

  3. Execute translation, files generated in current working directory:

    pdf2zh document.pdf

[!TIP]

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:

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:

Option Function Example
files Local files pdf2zh ~/local.pdf
links Online files pdf2zh http://arxiv.org/paper.pdf
-i Enter GUI pdf2zh -i
-p Partial document translation pdf2zh example.pdf -p 1
-li Source language pdf2zh example.pdf -li en
-lo Target language pdf2zh example.pdf -lo zh
-s Translation service pdf2zh example.pdf -s deepl
-t Multi-threads pdf2zh example.pdf -t 1
-o Output dir pdf2zh example.pdf -o output
-f, -c Exceptions pdf2zh example.pdf -f "(MS.*)"
-cp Compatibility Mode pdf2zh example.pdf --compatible
--skip-subset-fonts Skip font subset pdf2zh example.pdf --skip-subset-fonts
--ignore-cache Ignore translate cache pdf2zh example.pdf --ignore-cache
--share Public link pdf2zh -i --share
--authorized Authorization pdf2zh -i --authorized users.txt [auth.html]
--prompt Custom Prompt pdf2zh --prompt [prompt.txt]
--onnx [Use Custom DocLayout-YOLO ONNX model] pdf2zh --onnx [onnx/model/path]
--serverport [Use Custom WebUI port] pdf2zh --serverport 7860
--dir [batch translate] pdf2zh --dir /path/to/translate/
--config configuration file pdf2zh --config /path/to/config/config.json
--serverport [custom gradio server port] pdf2zh --serverport 7860
--babeldoc Use Experimental backend BabelDOC to translate pdf2zh --babeldoc -s openai example.pdf
--mcp Enable MCP STDIO mode pdf2zh --mcp
--sse Enable MCP SSE mode pdf2zh --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

  • Parse layout with DocLayNet based models, PaddleX, PaperMage, SAM2

  • Fix page rotation, table of contents, format of lists

  • Fix pixel formula in old papers

  • Async retry except KeyboardInterrupt

  • Knuth–Plass algorithm for western languages

  • Support non-PDF/A files

  • Plugins of Zotero and Obsidian

Acknowledgements

Contributors

Alt

Star History

Star History Chart

相关推荐

port

port

  • av

    • Exécutez sans effort LLM Backends, API, Frontends et Services avec une seule commande.

    2 (1)
    1panel

    1panel

  • 1Panel-dev

    • 🔥 1Panel fournit une interface Web intuitive et un serveur MCP pour gérer des sites Web, des fichiers, des conteneurs, des bases de données et des LLM sur un serveur Linux.

    2 (1)
    super-llm-resourses

    super-llm-resourses

  • WangRongsheng

    • 🧑‍🚀 全世界最好的 LLM 资料总结 （数据处理、模型训练、模型部署、 O1 模型、 MCP 、小语言模型、视觉语言模型） | Résumé des meilleures ressources LLM du monde.

    3.5 (4)
    règle

    règle

  • rulego

    • ⛓️RULEGO est un cadre de moteur de règle d'orchestration des composants de nouvelle génération légère, intégrée, intégrée et de nouvelle génération pour GO.

    3.7 (10)
    LLM-Functions

    LLM-Functions

  • sigoden

    • Créez facilement des outils et des agents LLM à l'aide de fonctions Plain Bash / JavaScript / Python.

    1 (1)
    CPP-MCP

    CPP-MCP

  • hkr04

    • SDK C ++ MCP (Protocole de contexte modèle léger)

    3 (1)
    Languette

    Languette

  • RockChinQ

    • 😎简单易用、🧩丰富生态 - 大模型原生即时通信机器人平台 | 适配 QQ / 微信 （企业微信、个人微信） / 飞书 / 钉钉 / Discord / Telegram / Slack 等平台 | 支持 Chatgpt 、 Deepseek 、 Dify 、 Claude 、 GEMINI 、 XAI 、 PPIO 、 OLLAMA 、 LM Studio 、阿里云百炼、火山方舟、 Siliconflow 、 Qwen 、 Moonshot 、 ChatGlm 、 Sillytraven 、 MCP 等 LLM 的机器人 / Agent | Plateforme de bots de messagerie instantanée basés sur LLM, prend en charge Discord, Telegram, WeChat, Lark, Dingtalk, QQ, Slack

    5 (1)
    minima

    minima

  • dmayboroda

    • Rag de conversation sur site avec des conteneurs configurables

    3 (5)
    test_mcp

    test_mcp

  • paulwing

    • Un référentiel de test créé à l'aide du service MCP

    3.3 (10)
    agents

    agents

  • modelscope

    • Commencez à construire des applications multi-agents LLM, plus facilement.

    2 (1)

    Reviews

    2 (1)
    Avatar
    user_5aECJTYa
    2025-04-23

    PDFMathTranslate by Byaidu is an indispensable tool for anyone dealing with mathematical documents. The ease with which it converts complex mathematical notations into comprehensible languages is groundbreaking. This app has significantly streamlined my workflow, enabling seamless translation of math content in PDFs. Highly recommended for educators, students, and professionals alike!