bcfbf51696
- controller: model.authenticationTranslatorLMStudio 呼び出しに base_url=config.LMSTUDIO_URL を明示的に渡すよう修正（LMStudio 接続判定で設定 URL を利用） - docs: 新規ドキュメントを追加・更新 - 追加: translation_gemini.md, translation_lmstudio.md, translation_ollama.md, translation_openai.md, translation_plamo.md - 更新: config.md, controller.md, mainloop.md, model.md, overlay.md, translation_languages.md, translation_translator.md, 仕様書.md（翻訳/モデル管理・エンドポイント・YAML 言語定義・フォント探索・VRAM フォールバック等の記載追加） - ドキュメントに記載した主な変更点 - LMStudio / Ollama のローカルLLM統合（モデルリスト/選択用プロパティ追加、接続確認エンドポイント） - CTranslate2 の言語定義を weight_type ネスト構造へ変更対応 - 外部 YAML による言語マッピング導入（loadTranslationLanguages） - フォント探索を PyInstaller バンドル(_internal/fonts/) を考慮して強化 - 認証後のモデルリスト自動更新・SELECTED_* プロパティ名統一、VRAM エラー検知時の自動フォールバック等の動作説明追加 （コードの振る舞いは既存処理に合わせた引数指定の修正とドキュメント反映が主体）
2.9 KiB
2.9 KiB
translation_ollama.py - Ollama ローカル LLM 翻訳クライアント
概要
Ollama サーバー上で稼働するローカル LLM を翻訳エンジンとして扱うためのクライアントラッパー。モデル一覧取得・モデル選択・翻訳実行を統一パターンで提供する。
最近の更新 (2025-10-20)
- 新規追加: Ollama を翻訳エンジン群へ統合
/api/pingを用いた疎通確認による簡易認証/api/tagsから利用可能モデル一覧抽出・ソート- YAML (
prompt/translation_ollama.yml) からシステムプロンプト (system_prompt) と対応言語をロード
影響
| 項目 | 内容 |
|---|---|
| 拡張性 | LAN 内ローカル推論を利用可能 |
| 可搬性 | GPU/CPU 任意構成の Ollama 環境に適応 |
| 一貫性 | 他翻訳クライアント (OpenAI/Gemini/Plamo/LMStudio) と統一 API |
責務
- Ollama インスタンスへの接続確認
- モデル一覧取得 (タグ列挙) とソート
- 選択モデルの検証と内部保持
- LangChain
ChatOllamaインスタンス生成 - システムプロンプトとユーザ入力を組み立てて翻訳実行
公開API (メソッド)
class OllamaClient:
def __init__(root_path: str = None)
def authenticationCheck() -> bool
def getModelList() -> list[str]
def getModel() -> str | None
def setModel(model: str) -> bool
def updateClient() -> None
def translate(text: str, input_lang: str, output_lang: str) -> str
メソッド詳細
authenticationCheck:/api/pingが 200 を返すかで利用可否判定getModelList: 認証成功時のみ/api/tags結果から name 抽出setModel: 取得済みモデル一覧内に存在する場合のみ設定updateClient:ChatOllamaを最新モデルで再生成translate: system / user メッセージを LLM へ送信し結合結果を正規化
使用例
client = OllamaClient()
if client.authenticationCheck():
models = client.getModelList()
if models:
client.setModel(models[0])
client.updateClient()
translated = client.translate("こんにちは世界", "Japanese", "English")
print(translated)
依存関係
requests: Ping/タグ API 呼び出しlangchain_ollama.ChatOllama: LangChain LLM ラッパーtranslation_languages.translation_lang: 対応言語集合translation_utils.loadPromptConfig: プロンプト YAML ロード
注意事項
- サーバー既定 URL:
http://localhost:11434 - モデル一覧取得は起動しているローカルサーバー状態に依存
updateClient()呼び出し前はtranslate()を利用不可
制限事項
- ストリーミング未対応 (streaming=False)
- エラー詳細は包括的に扱わない (上位層でフォールバック)
関連ドキュメント
details/translation_translator.mddetails/translation_languages.md