Chuyển đến nội dung

zyddnys / manga-image-translator

Manga Image Translator

Dịch chữ trong truyện tranh và ảnh một lần bấm: nhận diện, xoá chữ gốc rồi chèn chữ đã dịch vào

Công cụ này dịch văn bản nằm trong ảnh như trang manga, ảnh chụp màn hình hay hình trên diễn đàn. Nó tự tìm chữ, đọc chữ (OCR), dịch, xoá chữ gốc và chèn bản dịch trở lại đúng khung thoại. Thiết kế chính cho tiếng Nhật, cũng hỗ trợ tiếng Trung, tiếng Anh và khoảng 20 ngôn ngữ khác theo README.

  • 10.613 sao
  • 1.087 fork
  • Python
  • Cập nhật 5 ngày trước
  • GPL 3.0 (sửa đổi phải công bố mã)
Độ khó
Khó Dành cho người biết lập trình
Dạng
Dòng lệnh (CLI), Web tự cài (self-host)
Chạy trên
Python, Docker, Windows, Linux, macOS
Chi phí
Miễn phí (trả phí API AI nếu dùng)

Trải nghiệm khi dùng Manga Image Translator

Bạn cài Python, tải mã nguồn, tạo môi trường ảo rồi cài thư viện, sau đó chạy một lệnh trỏ vào thư mục ảnh. Công cụ tự tải các mô hình cần thiết vào thư mục models ở lần chạy đầu. Một lúc sau, bạn nhận một thư mục mới với đuôi translated chứa các trang đã được dịch.

Bên trong, ảnh đi qua từng bước: tìm vùng chữ, đọc chữ, dịch, xoá chữ gốc bằng kỹ thuật inpainting (vẽ bù nền) và chèn bản dịch với kiểu chữ phù hợp. Bạn có thể chọn công cụ dịch: dịch vụ trực tuyến như DeepL, mô hình ngôn ngữ như GPT qua API, hoặc các bộ dịch chạy offline có tên trong tài liệu như Sugoi, NLLB, M2M100.

Ngoài chế độ chạy hàng loạt, công cụ có chế độ máy chủ web để mở giao diện trong trình duyệt và chế độ API. Vì dự án tự nhận còn ở giai đoạn đầu và nhiều chỗ chưa hoàn hảo, bạn nên chuẩn bị chỉnh tay những chỗ chèn chữ chưa đẹp.

Tính năng nổi bật

Dịch ảnh một bước

Tìm chữ, OCR, dịch, xoá chữ cũ và chèn chữ mới trong cùng một quy trình.

Nhiều công cụ dịch

Chọn DeepL, mô hình ngôn ngữ qua API hoặc bộ dịch offline như Sugoi, NLLB, M2M100.

Chạy hàng loạt hoặc có giao diện web

Dịch cả thư mục ảnh bằng một lệnh, hoặc bật máy chủ web và API để dùng từ trình duyệt.

Hỗ trợ GPU

Có tuỳ chọn --use-gpu để tăng tốc nếu cài đúng bản PyTorch cho card đồ hoạ của bạn.

Từ điển thuật ngữ

README có phần Glossary và Replacement Dictionary để giữ nhất quán tên nhân vật và từ riêng.

Tận dụng Manga Image Translator vào việc gì?

Người đọc truyện, fan manga

Đọc truyện tranh chưa có bản dịch cho riêng mình

Dùng bản dịch máy để hiểu nội dung các trang không có bản dịch chính thức, mục đích cá nhân.

Dân văn phòng, người làm thương mại

Hiểu ảnh chụp màn hình tiếng nước ngoài

Dịch nhanh ảnh có chữ như hình quảng cáo, thông báo hay hướng dẫn sử dụng bằng ngoại ngữ.

Người bán hàng online, designer

Dịch banner, infographic để tham khảo

Xem nhanh ý nghĩa chữ trên ảnh sản phẩm của nhà cung cấp nước ngoài.

Lập trình viên

Dựng máy chủ dịch ảnh nội bộ

Chạy chế độ máy chủ và gọi API để tự động hoá việc dịch ảnh trong hệ thống của bạn.

Cần chuẩn bị gì?

  • Python 3.12 trở lên theo README; trên Windows cần cài Microsoft C++ Build Tools trước khi pip install vì một số gói phải biên dịch.
  • Git và trình biên dịch C++ (README nêu ví dụ build-essential trên Ubuntu) để cài các gói như pydensecrf.
  • Image Docker rất lớn, khoảng 15 GB theo README; cần ổ cứng trống tương ứng.
  • Card NVIDIA và bản PyTorch đúng với CUDA nếu muốn dùng GPU; không bắt buộc.

Hướng dẫn cài đặt chi tiết

Cài trên Python (khuyên dùng)

  1. Cài Python 3.12 trở lên và Git. Trên Windows cài thêm Microsoft C++ Build Tools. Sau đó tải mã nguồn.

    Terminal
    git clone https://github.com/zyddnys/manga-image-translator.git
    cd manga-image-translator
  2. Tạo môi trường ảo trên macOS hoặc Linux rồi cài thư viện.

    Terminal
    python -m venv venv
    source venv/bin/activate
    pip install -r requirements.txt
  3. Trên Windows PowerShell, kích hoạt môi trường ảo bằng cách sau rồi cài thư viện.

    PowerShell
    python -m venv venv
    .\venv\Scripts\Activate.ps1
    pip install -r requirements.txt
  4. Muốn dùng GPU, vào pytorch.org để cài đúng bản PyTorch khớp phiên bản CUDA trước (README nhắc thêm --upgrade --force-reinstall nếu không dùng môi trường ảo). Mô hình sẽ tự tải vào thư mục models khi chạy.

Cài trên Docker

  1. Cài Docker. Image chính thức là zyddnys/manga-image-translator:main và nặng khoảng 15 GB nên hãy đảm bảo đủ ổ cứng.

  2. Chạy ở chế độ dòng lệnh, trỏ vào thư mục ảnh. README yêu cầu mount thư mục vào /app và dùng đường dẫn bên trong container; hãy xem ví dụ chính xác ở mục Use as CLI của README.

    Văn bản
    https://github.com/zyddnys/manga-image-translator#use-as-cli
  3. Muốn chạy máy chủ web bằng compose, dùng các file có sẵn trong thư mục demo/doc của repo (CPU hoặc GPU), điền biến môi trường cần thiết trước.

    Terminal
    docker-compose -f demo/doc/docker-compose-web-with-cpu.yml up

Dùng thử lần đầu

  1. Chuẩn bị một thư mục chứa vài trang ảnh mà bạn có quyền sử dụng để thử.

  2. Chạy chế độ hàng loạt, thay đường dẫn bằng thư mục ảnh của bạn. Kết quả nằm ở thư mục cùng tên có đuôi -translated.

    Terminal
    python -m manga_translator local -v -i /duong/dan/thu-muc-anh
  3. Xem tất cả tuỳ chọn và cấu hình bằng lệnh sau, đặc biệt các mục chọn công cụ dịch và ngôn ngữ đích.

    Terminal
    python -m manga_translator config-help
  4. Mở các ảnh trong thư mục kết quả, kiểm tra chỗ chèn chữ và chỉnh tay nếu cần.

  5. Khi đã quen, thử chế độ web trong thư mục server để dùng giao diện trên trình duyệt (xem địa chỉ hiển thị trong Terminal).

    Terminal
    cd server
    python main.py --use-gpu

Mẹo dùng hay

  • Ảnh độ phân giải cao có thể cần tăng inpainting_size, nếu không phần chữ gốc có thể còn sót lại theo gợi ý trong README.
  • Dùng mô hình ngôn ngữ qua API thường cho bản dịch tự nhiên hơn bộ dịch offline, nhưng sẽ tốn phí API.
  • Dự án có danh sách thuật ngữ để giữ cách gọi tên nhân vật nhất quán qua nhiều trang.

Lưu ý và hạn chế

  • Chỉ nên dùng cho ảnh bạn có quyền sử dụng hoặc mục đích đọc cá nhân. Dịch rồi đăng lại truyện tranh có bản quyền (scanlation) có thể vi phạm quyền tác giả và điều khoản của nền tảng.
  • README tự nhận dự án còn ở giai đoạn đầu và có nhiều thiếu sót; kết quả có thể sai chữ, bể khung thoại hoặc chèn chữ chưa đẹp.
  • Cài đặt phức tạp (Python, trình biên dịch, PyTorch) và Docker nặng khoảng 15 GB; không dành cho người chưa quen dòng lệnh.
  • Hỗ trợ tiếng Việt như ngôn ngữ đích mình chưa xác nhận được từ README; hãy kiểm tra bảng mã ngôn ngữ trong tài liệu trước khi dùng.

Câu hỏi thường gặp

Có miễn phí không?

Phần mềm miễn phí, giấy phép GPL-3.0. Nếu bạn chọn bộ dịch cần API như DeepL hay mô hình ngôn ngữ trực tuyến thì phải trả phí cho họ; bộ dịch offline thì không.

Dịch sang tiếng Việt được không?

Mình không xác nhận được từ README. Hãy chạy lệnh config-help và xem phần Language Code Reference trong tài liệu để biết mã ngôn ngữ đích được hỗ trợ.

Có bản dùng thử không cần cài không?

README có liên kết bản trực tuyến chính thức do tác giả duy trì (cotrans.touhou.ai); trang này có thể tạm thời không truy cập được khi máy chủ khởi động lại.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/zyddnys/manga-image-translator.git

Repo tương tự nên xem

Tài liệu, OCR & hỏi đáp tri thức38,5K

PDFMathTranslate (pdf2zh)

PDFMathTranslate / PDFMathTranslate

Dịch PDF khoa học sang ngôn ngữ khác mà vẫn giữ công thức, biểu đồ, mục lục và bố cục

VừaWindowsmacOSLinuxDocker+1
Trợ lý & chat AI17,8K

LibreTranslate

LibreTranslate / LibreTranslate

Máy dịch mã nguồn mở tự cài trên máy mình, không phụ thuộc Google hay Azure, có giao diện web và API

VừaPythonDockerWebWindows+2
Tài liệu, OCR & hỏi đáp tri thức92,7K

PaddleOCR

PaddlePaddle / PaddleOCR

Bộ công cụ OCR của Baidu: đọc chữ trong ảnh, PDF và đổi tài liệu thành Markdown hoặc JSON.

KhóWindowsmacOSLinuxPython

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Trợ lý & chat AI

Trợ lý & chat AI159K

Open WebUI

open-webui / open-webui

Giao diện chat AI kiểu ChatGPT tự cài trên máy của bạn, nối được với Ollama và các API AI khác

VừaDockerPythonWindowsmacOS+1
Trợ lý & chat AI89K

NextChat (ChatGPT Next Web)

ChatGPTNextWeb / NextChat

Giao diện chat AI gọn nhẹ, tự dựng bằng khoá API của bạn, có sẵn bản máy tính, web và iOS

VừaWindowsmacOSLinuxiOS+2
Trợ lý & chat AI85,6K

LobeHub

lobehub / lobehub

Không gian làm việc với nhiều tác tử AI (agent) làm cùng nhóm bạn, dùng đám mây hoặc tự cài bằng Docker

VừaWebDockerWindowsmacOS+1
Trợ lý & chat AI68,3K

AnythingLLM

Mintplex-Labs / anything-llm

Ứng dụng AI tất-cả-trong-một: chat với tài liệu của bạn, dùng agent, chạy cục bộ hoặc nối mô hình đám mây

DễWindowsmacOSLinuxDocker+1
Trợ lý & chat AI53,6K

Cherry Studio

CherryHQ / cherry-studio

Ứng dụng máy tính gom nhiều mô hình AI, agent, kho tri thức và dịch thuật vào một chỗ

DễWindowsmacOSLinuxAndroid+1
Trợ lý & chat AI47,7K

TextGen (text-generation-webui)

oobabooga / textgen

Ứng dụng chạy mô hình ngôn ngữ trên máy, giải nén là dùng, riêng tư tuyệt đối và không thu thập dữ liệu

VừaWindowsmacOSLinuxPython

Xem cả 18 repo Trợ lý & chat AI Về Kho Repo