manga-image-translator:图像文字翻译

核心信息

以下信息由程序从官方接口读取，不经模型改写。

仓库地址: https://github.com/zyddnys/manga-image-translator
许可证: GPL-3.0
语言: Python
维护方: zyddnys
主页: https://cotrans.touhou.ai/
核验日期: 2026-11-01

它是什么

该项目旨在翻译不太可能有专业翻译的图像,例如各类群聊和图板上的漫画或图片。它主要支持日语,同时也支持简体中文、繁体中文、英语以及另外20种小语种。项目支持图像修复(文字去除)和排版。

主要能力

config-help 模式可以查看配置所用 JSON 模式的文档。
pre-dict 选项可以在翻译之前纠正常见的 OCR 错误或无关的特效文字。
post-dict 选项可以在翻译之后修改常见的误译或不自然的措辞,使其符合目标语言的习惯。
当输出格式设为 xcf、psd 或 pdf 时,会使用 Gimp 生成文件。
在 Windows 上,这要求 Gimp 2.x 安装在当前用户目录下的 AppData\Local\Programs\Gimp 2 文件夹中。
生成的 xcf 文件把原图作为最底层,把修复结果作为单独的一层。

怎么上手

本地安装时依赖被固定在当前发行版本。
本地安装需要在运行 pip 之前安装 Git 和 C++ 编译器。
Pip 会自动安装其 Cython 构建依赖。
模型会在运行时自动下载。
项目支持 Docker。
README 正文称 Web 服务器默认在 8000 端口启动;但本节附带的 Docker 命令用 -p 和 --port 显式指定了另一个端口,按该命令运行时请访问命令里指定的端口,而不是 8000。

摘自 README · bash

# First, ensure you have Python 3.12 or later installed on your machine
# The very latest version of Python might not be compatible with some PyTorch libraries yet
$ python --version
Python 3.13.16

# Clone this repository
$ git clone https://github.com/zyddnys/manga-image-translator.git

# Create a venv (optional, but recommended)
$ python -m venv venv

# Activate the venv
$ source venv/bin/activate

# If you want to use the --use-gpu option, please visit https://pytorch.org/get-started/locally/ to install PyTorch, which needs to correspond to your CUDA version.
# If you did not use venv to create a virtual environment, you need to add --upgrade --force-reinstall to the pip command to overwrite the currently installed PyTorch version.

# Install dependencies
$ pip install -r requirements.txt

摘自 README · bash

docker run \
  --name manga_image_translator_cpu \
  -p 5003:5003 \
  --ipc=host \
  --entrypoint python \
  --rm \
  -v /demo/doc/../../result:/app/result \
  -v /demo/doc/../../server/main.py:/app/server/main.py \
  -v /demo/doc/../../server/instance.py:/app/server/instance.py \
  -e OPENAI_API_KEY='' \
  -e OPENAI_API_BASE='' \
  zyddnys/manga-image-translator:main \
  server/main.py --verbose --start-instance --host=0.0.0.0 --port=5003

摘自 README · bash

# Replace <path> with the path to your image folder or file.
$ python -m manga_translator local -v -i <path>
# The results can be found in `<path_to_image_folder>-translated`.

适合谁

项目仍处于开发的早期阶段,存在许多不足。在线版本使用主分支的最新版本。在 Rust 版本中,stable diffusion 尚未重写,而且只提供命令行版本。

Docker 镜像包含项目所需的依赖和模型。该 Docker 镜像大小约为15GB。使用 CUDA 或 GPU 加速时,Docker 需要19.03或更高版本。

Nvidia Container Runtime 是可选的,只有想使用 CUDA 时才需要。在本地构建 Docker 镜像需要在机器上安装 make 工具。通过 Docker 使用命令行时,若要引用主机上的文件,需要把相关文件作为卷挂载到容器内。

部分翻译服务需要 API 密钥,要把它们作为环境变量传给 docker 容器。翻译器参考中的 API Key 列表示该翻译器是否需要把 API 密钥设置为环境变量。翻译器参考中的 Offline 列表示该翻译器是否可以离线使用。

env 文件包含敏感信息。提高 box_threshold 可以在一定程度上帮助过滤 OCR 误检产生的乱码。sakura_dict 术语表只对 sakuratranslator 有效。

custom_openai 无法加载术语表文件,OpenaiTranslator 可以加载。使用 Gimp 保存 psd 文件时,会把文字图层转换为普通图像。Gimp 处理旋转文字的效果不好。

本站已收录的相关工具。

来源

本页内容整理自以下官方来源，点击可核对原文。

GitHub READMEhttps://github.com/zyddnys/manga-image-translator抓取于 2026-10-31

核验日期 · 2026-11-01

本页由 AI 依据上述官方来源整理，并经自动核对，未经本站实测。发现错误？告诉我们。