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 / 다중 사용자 – 단일 인스턴스로 웹 UI나 REST API를 통해 로컬 네트워크의 여러 사용자에게 서비스를 제공할 수 있습니다.
- MCP 서버 – 다른 도구가 번역 작업을 스트리밍할 수 있도록 Model Context Protocol (MCP) 엔드포인트를 노출합니다.
- 포터블 바이너리 – Windows 및 macOS용 40 MB 미만의 패키지.
사용 방법
- 설치 –
pip install docutranslate(선택 사항으로[mcp]추가) 또는 Docker 이미지를 가져옵니다. - 구성 – LLM 공급자의 환경 변수(
DOCUTRANSLATE_API_KEY,BASE_URL,MODEL_ID등)를 설정합니다. - 실행 –
docutranslate -i로 웹 UI를 시작합니다.--host 0.0.0.0을 추가하면 LAN에서 공개할 수 있습니다. - 번역 – 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') - 고급 설정 – 하위 수준의 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 커뮤니티 링크가 있습니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트