meangrinch/MangaTranslator

MangaTranslator – ワンクリック AI 搭載漫画翻訳

概要

• 漫画/コミックページを受け取り、吹き出しや枠外テキストを検出し、元の文字を除去し、テキストを翻訳し、対象言語でページを再レンダリングするオープンソースの Python アプリです。複数の最新 ML コンポーネント（検出用 YOLO、OCR、翻訳用 LLM、インペインティング用拡散モデル）を、使いやすい Web UI（Gradio）または CLI に統合しています。

重要性

• スキャン翻訳（手動の漫画翻訳）は労働集約的です。MangaTranslator はパイプライン全体を自動化し、ユーザーがワンクリックで 60 以上の言語を翻訳しながら、アートワークを保存できます。

主な機能

• 検出 – YOLOv8、RT-DETR-v2、Meta の SAM 2/3 セグメンターによる吹き出しおよび枠外テキスト検出。
• クリーニング – FLUX 拡散モデルまたは高速な OpenCV フォールバックで除去されたテキストをインペイント。
• OCR と翻訳 – Manga-OCR、PaddleOCR-VL、および設定した任意の LLM プロバイダー（Google、OpenAI、Anthropic、DeepSeek、またはローカルの llama.cpp 互換エンドポイント）を使用。60 以上の言語をサポート。
• レンダリング – カスタムフォントパック、ワードラップ、配置、オプションの背景アート復元。
• アップスケーリング – テキスト領域またはページ全体用のオプションの 2× AnimeSharpV4 アップスケーラー。
• インターフェース – ドラッグアンドドロップ用のグラフィカル Web UI（Gradio）と、スクリプトおよびバッチ処理（フォルダー、ZIP/CBZ アーカイブ）用のフル機能 CLI。
• 柔軟性 – 多数の設定オプション（プロバイダーキー、枠外モデル用 HF トークン、クリーニングのみモード、フォントディレクトリなど）。

クイックスタート

1. ダウンロード – ポータブルビルド（Windows）を入手するか、リポジトリをクローンします。
2. インストール – Python 3.10+ の venv を作成し、PyTorch（GPU 用 CUDA 13.0）と requirements.txt をインストールします。
3. 設定 – Web UI で Config → Translation に移動し、LLM API キーを追加するか、環境変数（GEMINI_API_KEY、HF_TOKEN）を設定します。Hugging Face トークンを提供して枠外検出を有効にします。
4. 翻訳 – 画像（またはフォルダー/CBZ）をアップロードして Translate をクリックするか、以下を実行します：

   python main.py \
     --input "page.jpg" \
     --input-language Japanese \
     --output-language English \
     --font-dir fonts/KomikaHand \
     --provider Google --google-api-key <key> \
     --osb-enable --osb-hf-token <token>
   

ハードウェアに関する注意 – CUDA 13 対応 GPU（または macOS/CPU フォールバック）を推奨します。README に詳細なハードウェア要件ドキュメントへのリンクがあります。

ライセンスとクレジット

• Apache-2.0 ライセンス。
• コミュニティモデル（YOLO、SAM、FLUX、Manga-OCR など）と、torch、gradio、opencv、stable-diffusion.cpp などのライブラリに基づいて構築されています。

詳細情報

• 完全なドキュメント：インストール、設定、CLI 使用法、フォント処理、トラブルシューティング、ハードウェア要件はすべて docs/ フォルダーにあります。
• 役立つ場合は、Ko-fi で作者をサポートしてください。