argosopentech/argos-translate

Argos Translate – 오프라인 기계 번역 라이브러리

개요 – 인터넷 연결 없이 로컬에서 신경망 기계 번역 모델을 실행할 수 있는 Python 패키지입니다. OpenNMT / CTranslate2 추론 엔진을 래핑하며, 간단한 API, 명령줄 도구 및 (별도 저장소를 통해) 데스크톱 GUI를 제공합니다.

주요 기능

• 플러그인 언어 모델 – 번역 모델은 ".argosmodel" zip 파일로 배포됩니다. argospm-index 저장소에는 수십 개의 사전 학습된 모델(아랍어, 중국어, 프랑스어, 스와힐리어 등)이 나열되어 있으며, 패키지 관리자(argospm)를 통해 다운로드 및 설치할 수 있습니다.
• 피벗 번역 – 특정 언어 쌍에 대한 직접적인 모델이 없는 경우, Argos Translate는 설치된 모델을 사용하여 중간 언어를 통해 텍스트를 자동으로 라우팅할 수 있습니다 (예: es → en → fr).
• GPU 지원 – 환경 변수 ARGOS_DEVICE_TYPE=cuda (또는 auto)를 설정하면 하위 CTranslate2 엔진에 장치 선택이 전달되어 CUDA 가속을 활성화할 수 있습니다.
• 다양한 프런트엔드 –
  • Python 라이브러리 (argostranslate.translate.translate)
  • CLI (argos-translate 및 argospm 명령)
  • 데스크톱 GUI (별도의 argos-translate-gui 저장소)
  • Web/API – LibreTranslate 서비스는 Argos Translate를 기반으로 구축되었으며 REST 엔드포인트를 노출합니다.
• 확장 기능 – HTML 번역용(translate-html) 및 전체 파일용(argos-translate-files) 헬퍼 라이브러리.

설치

# 코어 라이브러리
pip install argostranslate

# 옵션 GUI
pip install argostranslategui

저장소를 클론한 후 가상 환경에서 pip install -e.를 사용하여 설치할 수도 있습니다.

빠른 예제 (Python)

import argostranslate.package, argostranslate.translate

from_code, to_code = "en", "es"
# 최신 모델 목록을 가져오고 필요한 쌍을 설치
argostranslate.package.update_package_index()
pkg = next(p for p in argostranslate.package.get_available_packages()
           if p.from_code == from_code and p.to_code == to_code)
argostranslate.package.install_from_path(pkg.download())

print(argostranslate.translate.translate("Hello World", from_code, to_code))
# → ¡Hola Mundo!

명령줄 사용법

argospm update                     # 모델 인덱스 새로 고침
argospm install translate-en_de    # 특정 모델 설치
argos-translate --from en --to de "Hello World!"
# → Hallo Welt!

생태계 및 관련 프로젝트

• LibreTranslate – 내부적으로 Argos Translate를 실행하는 공개 웹 API 및 데모 사이트.
• argos‑train – Argos Translate와 호환되는 자체 모델을 훈련하기 위한 스크립트.
• MetalTranslate – 동일한 번역 엔진을 래핑한 C++ 래퍼.
• 많은 언어(Python, Rust, Go, Java)에 대한 언어 모델 바인딩이 README에 나열되어 있습니다.

라이선스 – MIT 또는 CC0 하의 이중 라이선스로, 허용적인 상업적 이용과 퍼블릭 도메인 기여가 모두 가능합니다.

사용 대상 – 온디바이스 번역이 필요한 개발자(개인정보 보호가 중요한 앱, 엣지 장치, 오프라인 도구), OpenNMT 모델을 실험하는 연구자, 또는 클라우드 번역 서비스의 무료 자가 호스팅 대안을 원하는 모든 사람.