TranslateGemma ローカル翻訳アプリケーション

TranslateGemmaを利用したローカル翻訳Webアプリケーション。外部APIに依存せず、すべてローカルで動作します。

技術スタック

• SvelteKit (Svelte 5 runes) — フロントエンド + BFF（API Routes）
• SQLite (better-sqlite3) — 翻訳履歴・設定の永続化
• Ollama + TranslateGemma:12b — ローカル翻訳エンジン（デフォルト）
• OpenAI互換サーバー（LM Studio等） — 代替翻訳エンジン
• Bun — パッケージマネージャー / ランタイム
• Vitest + Playwright — テストフレームワーク

前提条件

• Bun 1.2以上
• 翻訳エンジン（いずれか）:
  • Ollama（デフォルト）: インストール済み・起動済み
    • 軽量: ollama pull translategemma:4b
    • 高品質: ollama pull translategemma:12b
  • OpenAI互換サーバー: LM Studio等のOpenAI互換API (/v1/chat/completions) を提供するサーバー

セットアップ & 起動

./start.sh        # Linux / WSL2
start.bat          # Windows

依存パッケージのインストールも自動で行われます。ブラウザで http://localhost:5173 が開きます。

手動で起動する場合:

cd app
bun install
bun run dev

テスト

cd app
bun run test          # Vitest ユニットテスト
bun run test:e2e      # Playwright E2Eテスト
bun run test:all      # 全テスト実行

設定

翻訳プロバイダー・接続先URL・モデル名は、Web UIのヘッダーにある歯車アイコンから設定できます。設定はSQLiteに保存され、サーバー再起動なしで反映されます。

設定画面の機能

• 翻訳プロバイダー: Ollama / OpenAI互換 の切り替え
• 接続先URL: プロバイダーごとの接続先URL入力
• モデル選択: サーバーから取得したモデル一覧のドロップダウン（取得できない場合はテキスト入力）
• 接続テスト: 現在の設定での接続確認
• 自動検出: ローカルおよびWSL2ホストのOllamaを自動検出（Ollama選択時のみ）

設定の優先順位

環境変数 (.env) > SQLite保存値 > デフォルト値

環境変数が設定されている場合はUIでロック表示となり変更できません。

環境変数（オプション）

app/.env で設定を固定したい場合のみ使用します。通常はWeb UIからの設定で十分です。

変数名	デフォルト値	説明
TRANSLATE_PROVIDER	ollama	翻訳プロバイダー (ollama / openai_compat)
OLLAMA_BASE_URL	http://127.0.0.1:11434	OllamaサーバーのURL
OLLAMA_MODEL	translategemma:12b	Ollamaモデル名
OPENAI_COMPAT_BASE_URL	http://localhost:1234	OpenAI互換サーバーのURL
OPENAI_COMPAT_MODEL	(空)	OpenAI互換モデル名
DB_PATH	./data/translation_history.db	SQLiteデータベースのパス

環境変数が設定されている項目はUIでロック表示となり変更できません。

WSL2環境での使用

WSL2からWindows側のOllamaを使用する場合、設定画面の「自動検出」ボタンでWindowsホストのOllamaを自動検出できます。

手動で設定する場合は、Windows側で環境変数 OLLAMA_HOST=0.0.0.0 を設定してOllamaを再起動してください。

プロジェクト構成

translateapp/
├── app/                # SvelteKit アプリケーション（BFF統合）
│   ├── src/
│   │   ├── routes/     #   ページ + API Routes (+server.ts)
│   │   └── lib/        #   共有ライブラリ（サーバー/クライアント）
│   └── e2e/            #   Playwright E2Eテスト
├── start.sh            # 起動スクリプト (Linux/WSL2)
└── start.bat           # 起動スクリプト (Windows)

機能

• 8言語間の翻訳（日本語、英語、中国語簡体字、韓国語、フランス語、ドイツ語、スペイン語、ポルトガル語）
• 言語ペアの入れ替え（スワップ）
• 翻訳履歴の自動保存
• 履歴の検索機能
• 履歴からの復元機能
• 履歴の削除機能（個別・全削除）
• Web UIからのOllama設定管理（URL・モデル変更、接続テスト、自動検出）
• 再翻訳確認モード: 原文をピン留めして逆翻訳し、原文と再翻訳結果のインラインdiff表示。差分hunkクリックで個別revert可能
• デバッグログパネル: 翻訳時のプロンプトと生レスポンスをタイムスタンプ付きで確認可能な折りたたみパネル

トラブルシューティング

Ollamaに接続できない

1. Ollamaが起動しているか確認: ollama list
2. TranslateGemmaモデルがインストールされているか確認
3. 設定画面の「接続テスト」ボタンで接続状態を確認
4. WSL2環境の場合は「自動検出」ボタンを試す
5. エラーメッセージに表示される接続先URLを確認

LM Studio で API error (400): "Conversations must start with a user prompt"

TranslateGemma はチャットモデルではないため、デフォルトのチャットテンプレートが /v1/chat/completions のメッセージ形式に対応していないことが原因です。LM Studio 側でモデルのテンプレートと停止トークンを設定してください。

1. LM Studio の My Models からロード中の TranslateGemma モデルを選択
2. モデル設定 > Prompt Template を開き、チャットテンプレート（Jinja）を設定する
   • 本アプリの設定画面（OpenAI互換 > サーバー設定ガイド）にテンプレート全文とコピーボタンがあります
3. 追加停止トークンに <end_of_turn> と <eos> を追加する
4. 設定を保存してモデルをリロードする