xunbu/docutranslate

文档(小说、论文、字幕)翻译工具(支持 pdf/word/excel/json/epub/srt...)Document (Novel, Thesis, Subtitle) Translation Tool (Supports pdf/word/excel/json/epub/srt...)

DocuTranslate – ローカルLLM駆動のドキュメント翻訳

概要 – DocuTranslateは、大規模言語モデル (LLMs) を使用して、自分のマシン上で幅広いファイル形式 (PDF, DOCX, XLSX, MD, TXT, JSON, EPUB, SRT, ASS, …) を翻訳できるPythonベースのツールです。ソースドキュメントを解析してテキストをチャンクに分割し、LLMベースの翻訳サービスに送信した後、元のレイアウトと書式を維持しながら結果を再構築します。

主な機能

  • マルチフォーマット対応 – プレーンテキストとリッチテキストの両方を処理。DOCX/XLSX出力はスタイルを保持します。
  • PDF処理 – MinerUエンジン(オンラインまたはセルフホスト)を使用して表、数式、コードを抽出し、PDFを一旦markdownに変換します(レイアウトが失われる可能性があります)。
  • 用語集 – 用語の一貫性を保つための自動生成用語集(オプション)。
  • 非同期・並列処理 – asyncioで構築されており、多数の翻訳リクエストを並行して実行可能です(デフォルトで10個のLLM呼び出しを並行処理)。
  • LAN / マルチユーザー – 単一のインスタンスで、Web UIまたはREST APIを介してローカルネットワーク上の複数のユーザーにサービスを提供できます。
  • MCPサーバー – 他のツールが翻訳ジョブをストリーミングするためのModel Context Protocol (MCP) エンドポイントを公開します。
  • ポータブルバイナリ – WindowsおよびmacOS用の40 MB未満のパッケージ。

使い方

  1. インストール – pip install docutranslate (オプションで [mcp] を追加) またはDockerイメージをプルします。
  2. 設定 – LLMプロバイダーの環境変数 (DOCUTRANSLATE_API_KEY, BASE_URL, MODEL_ID など) を設定します。
  3. 実行 – docutranslate -i でWeb UIを起動します。--host 0.0.0.0 を追加するとLAN上で公開できます。
  4. 翻訳 – UIからファイルをアップロードするか、REST API (/translate) を呼び出します。Python SDKも使用可能です:
    from docutranslate.sdk import Client
    client = Client(api_key='...', base_url='https://api.openai.com/v1', model_id='gpt-4o')
    result = client.translate('paper.pdf', convert_engine='mineru', mineru_token='...')
    result.save(fmt='html')
    
  5. 高度な設定 – 低レベルの Workflow クラスを使用して、詳細な制御(カスタムチャンクサイズ、挿入モード、JSONPath選択など)が可能です。

一般的なワークフロー

  • ファイルタイプの検出 → 適切な Workflow の選択 → PDFからmarkdownへの変換(オプション) → チャンクへの分割 → 各チャンクをLLMへ送信 → 翻訳済みチャンクの収集 → 元の形式でドキュメントを再構築(またはHTML/markdown/base64としてエクスポート)。

サポートされているLLMプロバイダー – 標準のOpenAI互換APIに従うすべてのサービス(OpenAI, Azure, Zhipuなど)。provider フィールドは auto または特定の名前を設定できます。

制限事項

  • PDFからmarkdownへの変換では、正確なページレイアウトが破棄されます。
  • レガシーな .doc や .xls ファイルのネイティブサポートはありません。
  • 用語集の生成はオプションであり、追加のLLM呼び出しが必要になる場合があります。

対象ユーザー – 学術論文を翻訳する研究者、小説をローカライズする作家、サードパーティのSaaSプラットフォームにデータを送信せずに内部文書の大量翻訳が必要なチーム。

リソース – GitHubのリリースにはすぐに実行可能なパッケージが含まれています。READMEにはMCPドキュメント、Dockerの使用方法、サポート用のQQコミュニティへのリンクがあります。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト