PDFMathTranslate

项目简介

PDFMathTranslate 用于翻译科学 PDF 文档，并保留其排版，包括公式、图表、目录和注释。它提供命令行、浏览器图形界面、Docker 和 Zotero 工作流，支持多种语言和翻译服务。

核心功能

• 在翻译后的 PDF 中保留公式、图表、目录和注释；支持多种语言及 Google、DeepL、Ollama、OpenAI 等多种翻译服务；生成单语翻译 PDF 和双语对照 PDF；提供命令行、交互式图形界面、Docker 和 Zotero 插件；包含面向纯图像页面的实验性 OCR，以及面向原生文本 PDF 的超快模式；为下游开发提供 Python 和 HTTP API。

适用场景

• 研究人员和开发者可在保留公式、图表和排版的情况下翻译科学论文；读者可同时生成单语翻译 PDF 和双语对照 PDF；团队可通过命令行或图形界面本地运行，也可使用 Docker 部署；开发者可通过 Python 或 HTTP API 将 PDF 翻译集成到下游应用。

快速开始

• 可使用 pip install pdf2zh 安装，或使用 uv tool install --python 3.12 pdf2zh；运行 pdf2zh document.pdf 翻译本地 PDF，输出文件生成在当前工作目录；使用 pdf2zh -i 启动浏览器图形界面，若未自动打开则访问本地 7860 端口；Docker 用户可拉取 byaidu/pdf2zh 并在 7860 端口运行。

部署与要求

• 本地 Python 安装要求 Python 3.11 至 3.12；Docker 部署使用 byaidu/pdf2zh 并暴露 7860 端口；另有 ghcr.io/byaidu/pdfmathtranslate 容器镜像可用；Windows 应用以 win64 zip 分发，若无法打开可安装 vc_redist.x64.exe。

采用前须知

• 许可证：AGPL-3.0。在使用、修改或分发项目前，请确认其具体条款。