feat: add OpenRouter provider support (200+ models, pay-per-use, free tier)

Author: bysiber

deepworm/__main__.py

@@ -1666,6 +1666,7 @@ def _show_models_interactive(config: "Config") -> None:
         "openai": ["gpt-4o", "gpt-4o-mini", "gpt-4-turbo", "gpt-3.5-turbo"],
         "anthropic": ["claude-sonnet-4-20250514", "claude-3-5-sonnet-20241022", "claude-3-haiku-20240307"],
         "google": ["gemini-2.5-flash-lite", "gemini-2.5-flash", "gemini-2.5-pro", "gemini-2.0-flash", "gemini-3-flash-preview"],
+        "openrouter": ["google/gemini-2.0-flash-exp:free", "google/gemini-2.5-flash-preview-05-20", "meta-llama/llama-3.1-8b-instruct:free", "microsoft/phi-3-mini-128k-instruct:free", "deepseek/deepseek-r1:free"],
         "ollama": ["llama3.2", "llama3.1", "mistral", "codellama", "phi3", "qwen2.5"],
     }
 
@@ -1706,7 +1707,7 @@ def _handle_set_command(user_input: str, config: "Config") -> None:
     value = parts[2].strip()
 
     if key == "provider":
-        valid = ("openai", "anthropic", "google", "ollama")
+        valid = ("openai", "anthropic", "google", "openrouter", "ollama")
         if value not in valid:
             console.print(f"  [yellow]Valid providers: {', '.join(valid)}[/yellow]")
             return

deepworm/config.py

@@ -79,7 +79,11 @@ def from_env(cls, **overrides: Any) -> "Config":
 
     def _detect_provider(self):
         """Auto-detect provider from environment variables."""
-        if os.getenv("OPENAI_API_KEY"):
+        if os.getenv("OPENROUTER_API_KEY"):
+            self.provider = "openrouter"
+            self.api_key = os.getenv("OPENROUTER_API_KEY")
+            self.base_url = "https://openrouter.ai/api/v1"
+        elif os.getenv("OPENAI_API_KEY"):
             self.provider = "openai"
             self.api_key = os.getenv("OPENAI_API_KEY")
         elif os.getenv("ANTHROPIC_API_KEY"):
@@ -100,6 +104,7 @@ def _default_model(self, provider: str | None = None) -> str:
             "openai": "gpt-4o-mini",
             "anthropic": "claude-3-5-haiku-latest",
             "google": "gemini-2.5-flash-lite",
+            "openrouter": "google/gemini-2.0-flash-exp:free",
             "ollama": "llama3.2",
         }
         return defaults.get(provider or self.provider, "gpt-4o-mini")
@@ -114,7 +119,7 @@ def validate(self) -> None:
         Raises:
             ValueError: If any configuration value is invalid.
         """
-        VALID_PROVIDERS = {"openai", "anthropic", "google", "ollama"}
+        VALID_PROVIDERS = {"openai", "anthropic", "google", "openrouter", "ollama"}
         VALID_FORMATS = {"markdown", "html", "text", "json", "pdf"}
         VALID_SEARCH_PROVIDERS = {"duckduckgo", "brave", "searxng"}
 

deepworm/llm.py

@@ -133,10 +133,22 @@ def get_client(config: Config) -> "LLMClient":
                 hint="Set GOOGLE_API_KEY environment variable or add api_key to config file",
             )
         return GoogleClient(api_key=api_key, model=config.model)
+    elif provider == "openrouter":
+        api_key = config.api_key or os.environ.get("OPENROUTER_API_KEY", "")
+        if not api_key:
+            raise APIKeyError(
+                "OpenRouter API key not found",
+                hint="Set OPENROUTER_API_KEY environment variable or add api_key to config file",
+            )
+        return OpenAICompatibleClient(
+            api_key=api_key,
+            base_url=config.base_url or "https://openrouter.ai/api/v1",
+            model=config.model,
+        )
     else:
         raise ProviderError(
             f"Unknown provider: {provider}",
-            hint="Supported providers: openai, anthropic, google, ollama",
+            hint="Supported providers: openai, anthropic, google, openrouter, ollama",
         )
 
 

tests/test_config.py

@@ -9,7 +9,7 @@
 def test_default_config():
     """Config should auto-detect provider."""
     config = Config.auto()
-    assert config.provider in ("openai", "anthropic", "google", "ollama")
+    assert config.provider in ("openai", "anthropic", "google", "openrouter", "ollama")
     assert config.model is not None
     assert config.depth == 1
     assert config.breadth == 1