Add OpenRouter as dedicated AI provider, bump to v1.9.371

michaelbeijer · claude · michaelbeijer · commit 742d1bc2d755 · 2026-04-02T23:14:37.000+01:00
OpenRouter gateway gives access to 200+ models with a single API key.
Curated dropdown of 8 models + editable field for any model ID.
Uses OpenAI-compatible API with HTTP-Referer/X-Title headers.

Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,9 +2,16 @@
 
 All notable changes to Supervertaler Workbench are documented in this file.
 
-**Current Version:** v1.9.370 (March 31, 2026)
+**Current Version:** v1.9.371 (April 2, 2026)
 
 
+## v1.9.371 - April 2, 2026
+
+### Added
+- **OpenRouter provider** – access 200+ models from OpenAI, Anthropic, Google, Mistral, and others with a single API key via openrouter.ai. Includes a curated dropdown of 8 recommended models (Claude Sonnet/Opus, GPT-5.4/Mini, Gemini 3.1 Pro/Flash, Mistral Small, Qwen 3.6 Plus Free) plus an editable model field for typing any OpenRouter model ID
+
+---
+
 ## v1.9.370 - March 31, 2026
 
 ### Changed
diff --git a/Supervertaler.py b/Supervertaler.py
@@ -9119,6 +9119,9 @@ def _update_llm_indicator(self):
             elif provider == 'mistral':
                 icon = "🌀"
                 display = f"{icon} {model}"
+            elif provider == 'openrouter':
+                icon = "🌐"
+                display = f"{icon} {model}"
             elif provider == 'custom_openai':
                 icon = "🔌"
                 profile = self._get_active_custom_profile(settings)
@@ -17876,6 +17879,11 @@ def _create_ai_settings_tab(self):
         provider_button_group.addButton(mistral_radio)
         provider_layout.addWidget(mistral_radio)
 
+        openrouter_radio = CustomRadioButton("🌐 OpenRouter (200+ models)")
+        openrouter_radio.setChecked(settings.get('provider', 'openai') == 'openrouter')
+        provider_button_group.addButton(openrouter_radio)
+        provider_layout.addWidget(openrouter_radio)
+
         # Local LLM option (Ollama)
         ollama_radio = CustomRadioButton("🖥️ Local LLM (Ollama - runs on your computer)")
         ollama_radio.setChecked(settings.get('provider', 'openai') == 'ollama')
@@ -18010,6 +18018,42 @@ def _create_ai_settings_tab(self):
 
         model_layout.addSpacing(10)
 
+        # OpenRouter models
+        openrouter_model_label = QLabel("<b>🌐 OpenRouter Models:</b>")
+        model_layout.addWidget(openrouter_model_label)
+
+        openrouter_combo = QComboBox()
+        openrouter_combo.setEditable(True)
+        openrouter_combo.addItems([
+            "anthropic/claude-sonnet-4.6 (Recommended)",
+            "anthropic/claude-opus-4.6 (Premium Reasoning)",
+            "openai/gpt-5.4 (Advanced Reasoning)",
+            "openai/gpt-5.4-mini (Fast & Economical)",
+            "google/gemini-3.1-pro-preview (Latest Gemini)",
+            "google/gemini-3-flash-preview (Fast Gemini)",
+            "mistralai/mistral-small-2603 (European Languages)",
+            "qwen/qwen3.6-plus:free (Free)"
+        ])
+        openrouter_combo.setToolTip(
+            "OpenRouter gives you access to 200+ models with a single API key.\n"
+            "Select a model from the dropdown or type any model ID from openrouter.ai/models.\n\n"
+            "Pricing varies per model — see openrouter.ai for details."
+        )
+        current_openrouter_model = settings.get('openrouter_model', 'anthropic/claude-sonnet-4.6')
+        # Try to select from dropdown, or set as typed text
+        found = False
+        for i in range(openrouter_combo.count()):
+            if current_openrouter_model in openrouter_combo.itemText(i):
+                openrouter_combo.setCurrentIndex(i)
+                found = True
+                break
+        if not found:
+            openrouter_combo.setEditText(current_openrouter_model)
+        openrouter_combo.setEnabled(openrouter_radio.isChecked())
+        model_layout.addWidget(openrouter_combo)
+
+        model_layout.addSpacing(10)
+
         # Local LLM (Ollama) models
         ollama_model_label = QLabel("<b>🖥️ Local LLM Models (Ollama):</b>")
         model_layout.addWidget(ollama_model_label)
@@ -18235,19 +18279,23 @@ def _update_provider_label(radio, base_name, combo):
             lambda: _update_provider_label(gemini_radio, "Google Gemini", gemini_combo))
         mistral_combo.currentIndexChanged.connect(
             lambda: _update_provider_label(mistral_radio, "Mistral AI", mistral_combo))
+        openrouter_combo.currentIndexChanged.connect(
+            lambda: _update_provider_label(openrouter_radio, "🌐 OpenRouter (200+ models)", openrouter_combo))
 
         # Set initial labels based on current combo selections
         _update_provider_label(openai_radio, "OpenAI", openai_combo)
         _update_provider_label(claude_radio, "Anthropic Claude", claude_combo)
         _update_provider_label(gemini_radio, "Google Gemini", gemini_combo)
         _update_provider_label(mistral_radio, "Mistral AI", mistral_combo)
+        _update_provider_label(openrouter_radio, "🌐 OpenRouter (200+ models)", openrouter_combo)
 
         # Connect radio buttons to enable/disable combos
         def update_combo_states():
             openai_combo.setEnabled(openai_radio.isChecked())
             claude_combo.setEnabled(claude_radio.isChecked())
             gemini_combo.setEnabled(gemini_radio.isChecked())
             mistral_combo.setEnabled(mistral_radio.isChecked())
+            openrouter_combo.setEnabled(openrouter_radio.isChecked())
             if ollama_status_widget:
                 ollama_status_widget.setEnabled(ollama_radio.isChecked())
             _custom_enabled = custom_radio.isChecked()
@@ -18292,6 +18340,7 @@ def on_ollama_selected(checked):
         claude_radio.toggled.connect(update_combo_states)
         gemini_radio.toggled.connect(update_combo_states)
         mistral_radio.toggled.connect(update_combo_states)
+        openrouter_radio.toggled.connect(update_combo_states)
         ollama_radio.toggled.connect(update_combo_states)
         ollama_radio.toggled.connect(on_ollama_selected)
         custom_radio.toggled.connect(update_combo_states)
@@ -18345,6 +18394,7 @@ def on_ollama_selected(checked):
             ("Claude (Anthropic):", "claude", "sk-ant-api03-..."),
             ("Gemini (Google AI):", "gemini", "AIza..."),
             ("Mistral AI:", "mistral", "..."),
+            ("OpenRouter:", "openrouter", "sk-or-..."),
             ("Ollama Endpoint:", "ollama_endpoint", "http://localhost:11434"),
         ]
 
@@ -18403,6 +18453,10 @@ def on_ollama_selected(checked):
         mistral_enable_cb.setChecked(enabled_providers.get('llm_mistral', True))
         provider_enable_layout.addWidget(mistral_enable_cb)
 
+        openrouter_enable_cb = CheckmarkCheckBox("Enable OpenRouter")
+        openrouter_enable_cb.setChecked(enabled_providers.get('llm_openrouter', True))
+        provider_enable_layout.addWidget(openrouter_enable_cb)
+
         ollama_enable_cb = CheckmarkCheckBox("Enable Local LLM (Ollama)")
         ollama_enable_cb.setChecked(enabled_providers.get('llm_ollama', True))
         provider_enable_layout.addWidget(ollama_enable_cb)
@@ -18762,7 +18816,9 @@ def update_ql_context_label(value):
             custom_model_input=custom_model_input, custom_enable_cb=custom_enable_cb,
             custom_profile_combo=custom_profile_combo, custom_key_input=custom_key_input,
             mistral_radio=mistral_radio, mistral_combo=mistral_combo,
-            mistral_enable_cb=mistral_enable_cb
+            mistral_enable_cb=mistral_enable_cb,
+            openrouter_radio=openrouter_radio, openrouter_combo=openrouter_combo,
+            openrouter_enable_cb=openrouter_enable_cb
         ))
         layout.addWidget(save_btn)
         
@@ -22559,7 +22615,9 @@ def _save_ai_settings_from_ui(self, openai_radio, claude_radio, gemini_radio, ol
                                    custom_model_input=None, custom_enable_cb=None,
                                    custom_profile_combo=None, custom_key_input=None,
                                    mistral_radio=None, mistral_combo=None,
-                                   mistral_enable_cb=None):
+                                   mistral_enable_cb=None,
+                                   openrouter_radio=None, openrouter_combo=None,
+                                   openrouter_enable_cb=None):
         """Save all AI settings from the unified AI Settings tab"""
         # Determine selected provider
         if openai_radio.isChecked():
@@ -22570,6 +22628,8 @@ def _save_ai_settings_from_ui(self, openai_radio, claude_radio, gemini_radio, ol
             provider = 'gemini'
         elif mistral_radio and mistral_radio.isChecked():
             provider = 'mistral'
+        elif openrouter_radio and openrouter_radio.isChecked():
+            provider = 'openrouter'
         elif ollama_radio.isChecked():
             provider = 'ollama'
         elif custom_radio and custom_radio.isChecked():
@@ -22608,6 +22668,7 @@ def _save_ai_settings_from_ui(self, openai_radio, claude_radio, gemini_radio, ol
             'claude_model': claude_combo.currentText().split()[0],
             'gemini_model': gemini_combo.currentText().split()[0],
             'mistral_model': mistral_combo.currentText().split()[0] if mistral_combo else 'mistral-large-latest',
+            'openrouter_model': openrouter_combo.currentText().split()[0] if openrouter_combo else 'anthropic/claude-sonnet-4.6',
             'ollama_model': ollama_model,
             'custom_openai_model': active_model,
             'custom_openai_endpoint': active_endpoint,
@@ -22627,6 +22688,7 @@ def _save_ai_settings_from_ui(self, openai_radio, claude_radio, gemini_radio, ol
             'llm_claude': claude_enable_cb.isChecked(),
             'llm_gemini': gemini_enable_cb.isChecked(),
             'llm_mistral': mistral_enable_cb.isChecked() if mistral_enable_cb else True,
+            'llm_openrouter': openrouter_enable_cb.isChecked() if openrouter_enable_cb else True,
             'llm_ollama': ollama_enable_cb.isChecked(),
             'llm_custom_openai': custom_enable_cb.isChecked() if custom_enable_cb else True
         }
@@ -47045,7 +47107,9 @@ def create_llm_client(self, provider, model, api_keys, settings=None):
         from modules.llm_clients import LLMClient
         api_key = api_keys.get(provider) or (api_keys.get('google') if provider == 'gemini' else None)
         base_url = None
-        if provider == 'custom_openai':
+        if provider == 'openrouter':
+            base_url = 'https://openrouter.ai/api/v1'
+        elif provider == 'custom_openai':
             if settings is None:
                 settings = self.load_llm_settings()
             profile = self._get_active_custom_profile(settings)
@@ -47069,6 +47133,7 @@ def load_provider_enabled_states(self) -> Dict[str, bool]:
             'llm_claude': True,
             'llm_gemini': True,
             'llm_mistral': True,
+            'llm_openrouter': True,
             'llm_ollama': True,
             'llm_custom_openai': True,
             'mt_google_translate': True,
diff --git a/modules/llm_clients.py b/modules/llm_clients.py
@@ -139,7 +139,7 @@ def _sanitize_ollama_endpoint(endpoint: str) -> str:
 @dataclass
 class LLMConfig:
     """Configuration for LLM client"""
-    provider: Literal["openai", "claude", "gemini", "mistral"]
+    provider: Literal["openai", "claude", "gemini", "mistral", "openrouter"]
     model: str
     api_key: str
     temperature: Optional[float] = None  # Auto-detected if None
@@ -156,7 +156,8 @@ class LLMClient:
         "gemini": "gemini-2.5-flash",  # Gemini 2.5 Flash (2025)
         "mistral": "mistral-large-latest",  # Mistral Large (flagship)
         "ollama": "translategemma:12b",  # Local LLM via Ollama - purpose-built translation model
-        "custom_openai": "custom-model"  # Custom OpenAI-compatible endpoint
+        "custom_openai": "custom-model",  # Custom OpenAI-compatible endpoint
+        "openrouter": "anthropic/claude-sonnet-4.6"  # OpenRouter gateway (200+ models)
     }
 
     # Available Mistral models with descriptions
@@ -181,6 +182,59 @@ class LLMClient:
         }
     }
     
+    # Available OpenRouter models (curated selection)
+    # OpenRouter is an API gateway — users can also type any model ID from openrouter.ai/models
+    OPENROUTER_MODELS = {
+        "anthropic/claude-sonnet-4.6": {
+            "name": "Claude Sonnet 4.6",
+            "description": "Anthropic flagship — fast, high quality",
+            "strengths": ["General translation", "Multilingual", "Fast"],
+            "use_case": "Recommended for most translation tasks"
+        },
+        "anthropic/claude-opus-4.6": {
+            "name": "Claude Opus 4.6",
+            "description": "Anthropic premium — best reasoning",
+            "strengths": ["Legal translation", "Technical documents", "Complex reasoning"],
+            "use_case": "Specialized legal/technical translation"
+        },
+        "openai/gpt-5.4": {
+            "name": "GPT 5.4",
+            "description": "OpenAI flagship — advanced reasoning",
+            "strengths": ["Complex reasoning", "Multilingual", "High accuracy"],
+            "use_case": "Complex translation tasks"
+        },
+        "openai/gpt-5.4-mini": {
+            "name": "GPT 5.4 Mini",
+            "description": "OpenAI fast & economical",
+            "strengths": ["Fast", "Cost-effective", "Multilingual"],
+            "use_case": "High-volume translation"
+        },
+        "google/gemini-3.1-pro-preview": {
+            "name": "Gemini 3.1 Pro",
+            "description": "Google latest — strong multilingual",
+            "strengths": ["Multilingual", "Large context", "High quality"],
+            "use_case": "General translation"
+        },
+        "google/gemini-3-flash-preview": {
+            "name": "Gemini 3 Flash",
+            "description": "Google fast — great for high volume",
+            "strengths": ["Fast", "Cost-effective", "Multilingual"],
+            "use_case": "High-volume translation"
+        },
+        "mistralai/mistral-small-2603": {
+            "name": "Mistral Small",
+            "description": "Mistral cost-effective — strong European languages",
+            "strengths": ["European languages", "Fast", "Cost-effective"],
+            "use_case": "European language translation"
+        },
+        "qwen/qwen3.6-plus:free": {
+            "name": "Qwen 3.6 Plus (Free)",
+            "description": "Free tier — no cost, good quality",
+            "strengths": ["Free", "Multilingual", "100+ languages"],
+            "use_case": "Testing or budget-constrained projects"
+        }
+    }
+
     # Available Ollama models with descriptions (for UI display)
     # Last audited: February 2026
     OLLAMA_MODELS = {
@@ -479,6 +533,10 @@ def __init__(self, api_key: str = None, provider: str = "openai", model: Optiona
         if self.provider == "mistral" and not self.base_url:
             self.base_url = "https://api.mistral.ai/v1"
 
+        # For OpenRouter, set the base URL and extra headers
+        if self.provider == "openrouter" and not self.base_url:
+            self.base_url = "https://openrouter.ai/api/v1"
+
         # Auto-detect temperature based on model
         self.temperature = self._get_temperature()
     
@@ -727,6 +785,8 @@ def translate(
             result = self._call_gemini(prompt, max_tokens=max_tokens, images=images, system_prompt=system_prompt)
         elif self.provider == "mistral":
             result = self._call_openai(prompt, max_tokens=max_tokens, images=None, system_prompt=system_prompt)
+        elif self.provider == "openrouter":
+            result = self._call_openai(prompt, max_tokens=max_tokens, images=None, system_prompt=system_prompt)
         elif self.provider == "ollama":
             result = self._call_ollama(prompt, max_tokens=max_tokens, system_prompt=system_prompt)
         else:
@@ -760,6 +820,11 @@ def _call_openai(self, prompt: str, max_tokens: Optional[int] = None, images: Op
         client_kwargs = {"api_key": self.api_key, "timeout": timeout_seconds}
         if self.base_url:
             client_kwargs["base_url"] = self.base_url
+        if self.provider == "openrouter":
+            client_kwargs["default_headers"] = {
+                "HTTP-Referer": "https://supervertaler.com",
+                "X-Title": "Supervertaler"
+            }
         if self.http_proxy:
             import httpx
             client_kwargs["http_client"] = httpx.Client(proxy=self.http_proxy, timeout=timeout_seconds)
diff --git a/pyproject.toml b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "supervertaler"
-version = "1.9.370"
+version = "1.9.371"
 description = "Professional AI-enhanced translation workbench with multi-LLM support, glossary system, TM, spellcheck, voice commands, and PyQt6 interface. Batteries included (core)."
 readme = "README.md"
 requires-python = ">=3.10"
