설치¶

필요한 것¶

uv — 빠른 Python 패키지 매니저. 설치:

macOS / LinuxWindows

curl -LsSf https://astral.sh/uv/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

LLM API 키 — 다음 중 하나:
- Google Gemini (무료 티어 사용 가능 — 시작용으로 추천)
- 모든 OpenAI 호환 엔드포인트 (OpenAI, 프록시를 통한 Anthropic, 로컬 Ollama / LM Studio 등)

도구	사용처	필요한 시점
FFmpeg (다운로드)	자막, 음성, 더빙, 라이브	모든 오디오/비디오 워크플로
LibreOffice (다운로드)	Linux/macOS의 Office 형식	레거시 `.doc` / `.xls` / `.ppt` 번역, 또는 MS Office가 설치되지 않았을 때 모든 Office 파일
Tesseract (설치 가이드)	OCR 엔진 (기본)	텍스트 추출 페이지, 스캔된 PDF 번역, 임베디드 이미지 번역
MS Office + pywin32	Windows의 Office	Windows에서 최고 충실도 Office 번역

이들 중 어느 것도 없이 AI Translate를 설치할 수 있습니다 — 필요한 기능은 실패하기 전에 알려줍니다.

git clone https://github.com/cadic2603/ai-translate.git
cd ai-translate
uv sync

이는 데스크톱 앱, CLI, MCP 서버를 실행하는 데 필요한 모든 것을 설치합니다.

데스크톱 앱명령줄MCP 서버

uv run python -m src.main

uv run ait --version

uv run ait-mcp           # stdio 전송 (Claude Desktop / Code용)

데스크톱 앱을 처음 열 때:

사이드바에서 설정 클릭
LLM 탭 열기
Google Gemini API 키를 붙여넣기 (또는 OpenAI 호환 사용자 지정 제공자 구성). 엔터프라이즈 사용자는 Gemini를 Vertex AI 모드로 전환할 수 있습니다 — GCP 프로젝트와 리전을 가리키고, 선택적으로 service-account JSON 경로 제공; 세부 사항은 LLM 제공자 참조.
기본 모델 선택 — 모든 현재 Flash 변형 (예: gemini-2.5-flash)이 견고한 무료 시작점입니다. Pro 변형은 더 높은 비용으로 더 나은 품질을 제공.
설정 닫기 — 완료

키는 디스크의 일반 텍스트가 아닌 OS 키체인(macOS Keychain, Windows Credential Manager, Linux의 GNOME / KDE Secret Service)에 저장됩니다.

헤드리스 / 서버 설치

키를 설정하기 위해 데스크톱 앱을 실행할 수 없는 경우, keychain CLI 명령에 대해서는 LLM 제공자를 참조.