PDFMathTranslate

1. PDFMathTranslate là gì?

PDFMathTranslate (còn gọi là pdf2zh) là công cụ miễn phí dịch cả file PDF sang ngôn ngữ khác mà giữ nguyên bố cục: công thức toán, biểu đồ, bảng, mục lục và chú thích vẫn nằm đúng chỗ. Dự án ra đời để dịch bài báo khoa học, và được giới thiệu tại hội nghị EMNLP 2025. Bạn đưa vào một file PDF, nhận lại hai file: bản chỉ có ngôn ngữ đã dịch và bản song ngữ.

Nó thay cho việc copy từng đoạn vào Google Dịch rồi dán lại (mất hết định dạng), hoặc các dịch vụ dịch tài liệu trả phí. Dịch vụ mặc định là Google nên không cần khóa API. Dự án dùng giấy phép AGPL-3.0.

Hợp với bạn nếu:

• Bạn đọc bài báo, tài liệu kỹ thuật, giáo trình bằng tiếng Anh dưới dạng PDF và muốn bản dịch nhìn giống bản gốc.
• Bạn muốn một bản song ngữ để đối chiếu từng đoạn.
• Bạn không muốn trả tiền hoặc không muốn đăng ký dịch vụ dịch tài liệu.

Chưa hợp nếu:

• Bạn cần bản dịch tiếng Việt thật mượt, đã được kiểm chứng. README và tài liệu giao diện của dự án không liệt kê tiếng Việt trong danh sách ngôn ngữ được hỗ trợ chính thức của giao diện web (có 10 ngôn ngữ: Anh, Trung giản thể và phồn thể, Pháp, Đức, Nhật, Hàn, Nga, Tây Ban Nha, Ý). Dòng lệnh nhận mã ngôn ngữ của Google nên vi là mã hợp lệ, nhưng bạn nên thử trên một file ngắn trước.
• File PDF của bạn là bản scan toàn ảnh. Phần OCR (đọc chữ từ ảnh) trong dự án đang là tính năng thử nghiệm.
• Bạn dịch tài liệu bí mật. Dịch vụ dịch mặc định gửi nội dung văn bản lên Google, nên hãy cân nhắc.

2. Cần chuẩn bị gì?

Có ba đường, từ dễ đến khó:

1. Dùng trên web, không cài gì. Cần trình duyệt và mạng. Trang https://pdf2zh.com/ do dự án giới thiệu (README ghi "Public free service", dùng miễn phí không cần cài). Tài nguyên có hạn nên đừng lạm dụng.
2. Bản chạy trên Windows (file .zip). Cần Windows 64-bit. Nếu mở không được, cài thêm "Microsoft Visual C++ Redistributable" (gói thành phần mà nhiều chương trình Windows cần): vc_redist.x64.exe tại https://aka.ms/vs/17/release/vc_redist.x64.exe, theo gợi ý của README.
3. Cài bằng Python hoặc Docker. Cần Python (ngôn ngữ lập trình, tải tại https://www.python.org/downloads/) phiên bản từ 3.11 đến 3.12, hoặc Docker (phần mềm chạy ứng dụng trong "hộp" đóng gói sẵn) tại https://www.docker.com/.

Không cần tài khoản, không cần khóa API nếu dùng dịch vụ Google mặc định. Lần chạy đầu, chương trình tải thêm một mô hình AI nhận dạng bố cục trang, nên cần mạng và vài trăm MB trống (tài liệu không nêu con số chính xác).

3. Cài đặt từng bước

Cách A: Dùng trên web

1. Vào https://pdf2zh.com/.
2. Kéo file PDF vào, chọn ngôn ngữ dịch, bấm dịch. Giới hạn kích thước và số lượt dùng do trang quy định, hãy xem trên trang.

Nhận được file PDF đã dịch để tải về là đúng.

Cách B: Windows, bản .zip (không cần Python)

Bước 1: Tải

Vào https://github.com/PDFMathTranslate/PDFMathTranslate/releases, tải tệp pdf2zh-v1.9.11-win64.zip (v1.9.11 là bản phát hành mới nhất trên trang Releases, đăng tháng 7/2025). Có thêm tệp with-assets chứa sẵn mô hình, dùng khi bạn không tải được mô hình lúc chạy.

Bước 2: Giải nén và chạy

Giải nén, rồi bấm đúp vào pdf2zh.exe. Nếu Windows không mở được, cài vc_redist.x64.exe như ở mục 2 rồi thử lại.

Thấy một cửa sổ giao diện hoặc trang trình duyệt mở ra là đúng.

Cách C: Cài bằng Python

Bước 1: Cài Python

Cài Python 3.11 hoặc 3.12 từ https://www.python.org/downloads/. Trên Windows, tick ô "Add python.exe to PATH" ở màn hình đầu tiên của trình cài đặt.

Bước 2: Cài pdf2zh

Mở Terminal (macOS/Linux) hoặc PowerShell (Windows) và gõ:

pip install pdf2zh

Cài xong, không có lỗi đỏ là đúng. (README còn nêu cách dùng uv: pip install uv rồi uv tool install --python 3.12 pdf2zh.)

Bước 3: Mở giao diện trên trình duyệt

pdf2zh -i

Nếu trình duyệt không tự mở, vào http://localhost:7860/. Thả file PDF vào cửa sổ và bấm Translate.

Cách D: Docker

docker pull byaidu/pdf2zh
docker run -d -p 7860:7860 byaidu/pdf2zh

Rồi mở http://localhost:7860/.

4. Dùng lần đầu

Cách nhanh nhất để thử là dòng lệnh, trong thư mục chứa file PDF:

pdf2zh document.pdf

Chương trình tạo hai file trong thư mục hiện tại, theo README: document-mono.pdf (chỉ có bản dịch) và document-dual.pdf (song ngữ).

Lưu ý quan trọng: Mặc định ngôn ngữ đích là tiếng Trung giản thể (README dùng -lo zh làm ví dụ, tài liệu giao diện ghi mặc định "Simplified Chinese"). Để chọn ngôn ngữ khác, thêm -li (ngôn ngữ gốc) và -lo (ngôn ngữ đích), ví dụ:

pdf2zh document.pdf -li en -lo vi

Mã ngôn ngữ theo chuẩn của Google và DeepL. Tiếng Việt không có trong danh sách giao diện chính thức nên hãy thử với một file ngắn, đối chiếu bản song ngữ rồi mới dịch tài liệu dài. Muốn dịch riêng vài trang, thêm -p 1 (chỉ trang 1).

5. Lỗi thường gặp và cách sửa

Dấu hiệu	Nguyên nhân thường gặp	Cách sửa
pdf2zh hoặc pip báo "command not found" / "not recognized"	Chưa cài Python hoặc chưa thêm vào PATH	Cài lại Python, tick "Add python.exe to PATH", mở terminal mới
Cài báo lỗi phiên bản Python	README yêu cầu Python 3.11 đến 3.12	Cài Python 3.12 rồi chạy lại
Dừng ở bước tải mô hình, không tải được	Mạng ở một số nơi không vào được kho mô hình (Hugging Face)	Đặt biến HF_ENDPOINT=https://hf-mirror.com như README hướng dẫn (PowerShell: $env:HF_ENDPOINT = "https://hf-mirror.com"), hoặc dùng bản zip with-assets
Bản dịch ra tiếng Trung	Chưa đặt ngôn ngữ đích	Thêm -lo vi (hoặc mã ngôn ngữ khác)
pdf2zh.exe không mở được trên Windows	Thiếu thành phần Visual C++	Cài vc_redist.x64.exe rồi thử lại
Cổng 7860 đã bị chiếm	Chương trình khác đang dùng	Thêm --serverport 7861 rồi mở cổng mới

Nếu vẫn lỗi, xem phần câu hỏi thường gặp (FAQ) trong wiki của dự án: https://github.com/PDFMathTranslate/PDFMathTranslate/wiki

6. Gỡ cài đặt / cập nhật

• Python: gỡ bằng pip uninstall pdf2zh; cập nhật bằng pip install -U pdf2zh. Nếu cài bằng uv, dùng uv tool uninstall pdf2zh.
• Bản zip Windows: xóa thư mục đã giải nén; cập nhật bằng cách tải bản zip mới.
• Docker: dừng và xóa container trong Docker Desktop; cập nhật bằng docker pull byaidu/pdf2zh.

7. Câu hỏi hay gặp

Có mất tiền không? Bản chương trình miễn phí. Dịch vụ dịch mặc định (Google) không cần khóa. Nếu bạn chọn dịch vụ khác như OpenAI hay DeepL, bạn cần khóa API riêng và nhà cung cấp có thể tính phí.

Dữ liệu có bị gửi đi đâu không? Với dịch vụ mặc định, văn bản trong PDF được gửi tới dịch vụ dịch để dịch. Dự án có hỗ trợ cả dịch vụ chạy cục bộ như Ollama (xem tài liệu nâng cao) nếu bạn muốn giữ trong máy.

Có cần mạng không? Có: để tải mô hình lần đầu và để gọi dịch vụ dịch.

Có hợp để dịch tài liệu thường không phải khoa học không? Dự án nhắm vào bài báo khoa học, nhưng README mô tả đây là công cụ dịch PDF giữ bố cục. Hãy thử trên file của bạn trước.

Còn có công cụ nào khác trên githot cho PDF? Có: BentoPDF (công cụ PDF chạy trong trình duyệt) tại https://www.githot.io.vn/bentopdf, và RetainPDF tại https://www.githot.io.vn/retain-pdf.