インストール¶

必要なもの¶

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 プロジェクトとリージョンを指定し、オプションでサービスアカウント JSON パスを提供; 詳細は LLM プロバイダーを参照。
デフォルトモデルを選択 — 任意の現行 Flash バリアント (例: gemini-2.5-flash)が手堅い無料の出発点。Pro バリアントは高コストでより良い品質を提供。
設定を閉じる — 完了

キーはディスク上のプレーンテキストではなく OS キーチェーン (macOS Keychain、Windows Credential Manager、Linux の GNOME / KDE Secret Service)に保存されます。

ヘッドレス / サーバーインストール

キーをセットアップするのにデスクトップアプリを実行できない場合、 keychain CLI コマンドについて LLM プロバイダーを参照。