evidor 1.10.1.dev1__tar.gz → 1.10.2.dev1__tar.gz

{evidor-1.10.1.dev1 → evidor-1.10.2.dev1}/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 <!-- version list -->
 
+## v1.10.2-dev.1 (2026-10-21)
+
+### Bug Fixes
+
+- **agent**: Adding base url support
+  ([`f5f787f`](https://github.com/vedangiitb/evidor-core/commit/f5f787f3ab9015c73d6637b74c4af6fc7649035a))
+
+
+## v1.10.1 (2026-10-20)
+
+
 ## v1.10.1-dev.1 (2026-10-20)
 
 ### Bug Fixes

{evidor-1.10.1.dev1 → evidor-1.10.2.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: evidor
-Version: 1.10.1-dev.1
+Version: 1.10.2-dev.1
 Summary: A small, provider-agnostic harness for LLM input and output.
 Project-URL: Homepage, https://github.com/evidor/evidor-core
 Project-URL: Repository, https://github.com/evidor/evidor-core
@@ -1255,7 +1255,15 @@ Supported providers, example models, and reasoning/thinking support:
 | `AnthropicProvider` | `claude-3-7-sonnet` | Extended budget (`budget_tokens >= 1024`) or adaptive | `ANTHROPIC_API_KEY` | `evidor[anthropic]` |
 | `GeminiProvider` | `gemini-3.8-flash`, `gemini-3.5-flash-lite`, `gemini-3.1-pro-preview` | `thinking_level` (`"minimal"`, `"low"`, `"medium"`, `"high"`) or budget | `GEMINI_API_KEY` | `evidor[gemini]` |
 
-API keys can be supplied explicitly via the `api_key` constructor argument or read automatically from environment variables.
+API keys can be supplied explicitly via the `api_key` constructor argument or read automatically from environment variables. Custom base URLs for OpenAI-compatible providers (such as DeepSeek) can be supplied via the `base_url` constructor argument or `OPENAI_BASE_URL` environment variable:
+
+```python
+provider = OpenAIProvider(
+    model="deepseek-flash",
+    api_key="your-deepseek-api-key",
+    base_url="https://api.deepseek.com",
+)
+```
 
 ### Modern Provider APIs & Zero Legacy Fallbacks
 

{evidor-1.10.1.dev1 → evidor-1.10.2.dev1}/README.md

@@ -1168,7 +1168,15 @@ Supported providers, example models, and reasoning/thinking support:
 | `AnthropicProvider` | `claude-3-7-sonnet` | Extended budget (`budget_tokens >= 1024`) or adaptive | `ANTHROPIC_API_KEY` | `evidor[anthropic]` |
 | `GeminiProvider` | `gemini-3.8-flash`, `gemini-3.5-flash-lite`, `gemini-3.1-pro-preview` | `thinking_level` (`"minimal"`, `"low"`, `"medium"`, `"high"`) or budget | `GEMINI_API_KEY` | `evidor[gemini]` |
 
-API keys can be supplied explicitly via the `api_key` constructor argument or read automatically from environment variables.
+API keys can be supplied explicitly via the `api_key` constructor argument or read automatically from environment variables. Custom base URLs for OpenAI-compatible providers (such as DeepSeek) can be supplied via the `base_url` constructor argument or `OPENAI_BASE_URL` environment variable:
+
+```python
+provider = OpenAIProvider(
+    model="deepseek-flash",
+    api_key="your-deepseek-api-key",
+    base_url="https://api.deepseek.com",
+)
+```
 
 ### Modern Provider APIs & Zero Legacy Fallbacks
 

{evidor-1.10.1.dev1 → evidor-1.10.2.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "evidor"
-version = "1.10.1-dev.1"
+version = "1.10.2-dev.1"
 description = "A small, provider-agnostic harness for LLM input and output."
 readme = "README.md"
 requires-python = ">=3.10"

{evidor-1.10.1.dev1 → evidor-1.10.2.dev1}/src/evidor/agent/providers/base.py

@@ -131,6 +131,11 @@ class BaseProvider:
         """The token threshold for provider-native context compaction, if configured."""
         return getattr(self, "_compact_threshold", None)
 
+    @property
+    def base_url(self) -> str | None:
+        """The custom base URL for the model provider endpoint, if configured."""
+        return getattr(self, "_base_url", None)
+
     async def generate_async(
         self, request: GenerationRequest, *, stream: bool = False
     ) -> GenerationResponse | AsyncStreamResponse:

{evidor-1.10.1.dev1 → evidor-1.10.2.dev1}/src/evidor/agent/providers/openai.py

@@ -65,6 +65,7 @@ class OpenAIProvider(BaseProvider):
         api_key: str | None = None,
         thinking: Any = None,
         compact_threshold: int | None = None,
+        base_url: str | None = None,
     ) -> None:
         if thinking is not None:
             from evidor.models import OpenAIThinkingConfig
@@ -80,6 +81,7 @@ class OpenAIProvider(BaseProvider):
 
         super().__init__(model=model, api_key=api_key, thinking=thinking_cfg)
         self._compact_threshold = compact_threshold
+        self._base_url = base_url
         self._sync_client: Any = None
         self._default_async_client: Any = None
 
@@ -91,12 +93,18 @@ class OpenAIProvider(BaseProvider):
     def compact_threshold(self) -> int | None:
         return self._compact_threshold
 
+    @property
+    def base_url(self) -> str | None:
+        """The custom base URL for OpenAI-compatible endpoints, if configured."""
+        return self._base_url
+
     def with_model(self, model: str) -> "OpenAIProvider":
         return OpenAIProvider(
             model=model,
             api_key=self._api_key,
             thinking=self._thinking,
             compact_threshold=self._compact_threshold,
+            base_url=self._base_url,
         )
 
     @overload
@@ -291,7 +299,10 @@ class OpenAIProvider(BaseProvider):
             except ImportError as error:
                 raise ImportError("Install OpenAI support with: pip install 'evidor[openai]'") from error
 
-            client = OpenAI(api_key=self._api_key)
+            client_kwargs: dict[str, Any] = {"api_key": self._api_key}
+            if self._base_url is not None:
+                client_kwargs["base_url"] = self._base_url
+            client = OpenAI(**client_kwargs)
             if not hasattr(client, "responses") or not hasattr(client.responses, "create"):
                 raise RuntimeError(
                     "Modern OpenAI Responses API (client.responses.create) is required. "
@@ -320,14 +331,18 @@ class OpenAIProvider(BaseProvider):
             for l in dead_loops:
                 del self._async_clients[l]
 
+            client_kwargs: dict[str, Any] = {"api_key": self._api_key}
+            if self._base_url is not None:
+                client_kwargs["base_url"] = self._base_url
+
             if loop is not None:
                 client = self._async_clients.get(loop)
                 if is_client_closed(client):
-                    client = AsyncOpenAI(api_key=self._api_key)
+                    client = AsyncOpenAI(**client_kwargs)
                     self._async_clients[loop] = client
             else:
                 if is_client_closed(self._default_async_client):
-                    self._default_async_client = AsyncOpenAI(api_key=self._api_key)
+                    self._default_async_client = AsyncOpenAI(**client_kwargs)
                 client = self._default_async_client
 
         if not hasattr(client, "responses") or not hasattr(client.responses, "create"):

{evidor-1.10.1.dev1 → evidor-1.10.2.dev1}/tests/test_providers.py

@@ -22,12 +22,14 @@ from evidor import (
 
 
 def test_openai_provider_properties_and_with_model() -> None:
-    provider = OpenAIProvider(model="gpt-4.1", api_key="sk-test")
+    provider = OpenAIProvider(model="gpt-4.1", api_key="sk-test", base_url="https://api.deepseek.com")
     assert provider.model == "gpt-4.1"
+    assert provider.base_url == "https://api.deepseek.com"
 
     new_provider = provider.with_model("gpt-4.1-mini")
     assert new_provider.model == "gpt-4.1-mini"
     assert new_provider._api_key == "sk-test"
+    assert new_provider.base_url == "https://api.deepseek.com"
 
 
 def test_openai_provider_generate(monkeypatch: pytest.MonkeyPatch) -> None:
@@ -60,6 +62,54 @@ def test_openai_provider_generate(monkeypatch: pytest.MonkeyPatch) -> None:
     )
 
 
+def test_openai_provider_generate_with_base_url(monkeypatch: pytest.MonkeyPatch) -> None:
+    mock_openai = types.ModuleType("openai")
+    mock_client = MagicMock()
+    mock_response = MagicMock(output_text="DeepSeek text")
+    mock_client.responses.create.return_value = mock_response
+    mock_openai.OpenAI = MagicMock(return_value=mock_client)  # type: ignore[attr-defined]
+
+    monkeypatch.setitem(sys.modules, "openai", mock_openai)
+
+    provider = OpenAIProvider(
+        model="deepseek-flash",
+        api_key="ds-key",
+        base_url="https://api.deepseek.com",
+    )
+    request = GenerationRequest(prompt="Hello DeepSeek")
+    response = provider.generate(request)
+
+    assert response.text == "DeepSeek text"
+    mock_openai.OpenAI.assert_called_once_with(api_key="ds-key", base_url="https://api.deepseek.com")
+
+
+@pytest.mark.asyncio
+async def test_openai_provider_async_with_base_url(monkeypatch: pytest.MonkeyPatch) -> None:
+    mock_openai = types.ModuleType("openai")
+    mock_client = MagicMock()
+    mock_client.is_closed = False
+    mock_response = MagicMock(output_text="DeepSeek async text")
+
+    async def _async_create(**kwargs: Any) -> Any:
+        return mock_response
+
+    mock_client.responses.create = _async_create
+    mock_openai.AsyncOpenAI = MagicMock(return_value=mock_client)  # type: ignore[attr-defined]
+
+    monkeypatch.setitem(sys.modules, "openai", mock_openai)
+
+    provider = OpenAIProvider(
+        model="deepseek-flash",
+        api_key="ds-key",
+        base_url="https://api.deepseek.com",
+    )
+    request = GenerationRequest(prompt="Hello DeepSeek async")
+    response = await provider.generate_async(request)
+
+    assert response.text == "DeepSeek async text"
+    mock_openai.AsyncOpenAI.assert_called_once_with(api_key="ds-key", base_url="https://api.deepseek.com")
+
+
 
 
 def test_openai_provider_import_error(monkeypatch: pytest.MonkeyPatch) -> None: