llmswitch-sdk 0.1.0__tar.gz

llmswitch_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rituraj Raman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

llmswitch_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,214 @@
+Metadata-Version: 2.4
+Name: llmswitch-sdk
+Version: 0.1.0
+Summary: One Python client for chat completions and embeddings across OpenAI, Azure OpenAI, Azure AI Foundry, Anthropic and Vertex AI.
+Author: Rituraj Raman
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/RITURAJRAMAN/llmswitch
+Project-URL: Repository, https://github.com/RITURAJRAMAN/llmswitch
+Project-URL: Issues, https://github.com/RITURAJRAMAN/llmswitch/issues
+Project-URL: Changelog, https://github.com/RITURAJRAMAN/llmswitch/blob/main/CHANGELOG.md
+Keywords: llm,openai,azure,anthropic,vertex-ai,embeddings,chat-completions
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic<3,>=2.14.1
+Requires-Dist: openai<4.0.0,>=3.36.1
+Provides-Extra: anthropic
+Requires-Dist: anthropic<3,>=2.1.0; extra == "anthropic"
+Provides-Extra: azure-foundry
+Requires-Dist: azure-ai-inference==1.0.0b9; extra == "azure-foundry"
+Requires-Dist: aiohttp<4.0.0,>=3.14.5; extra == "azure-foundry"
+Provides-Extra: vertexai
+Requires-Dist: google-genai<3,>=2.32.0; extra == "vertexai"
+Provides-Extra: all
+Requires-Dist: llmswitch-sdk[anthropic,azure-foundry,vertexai]; extra == "all"
+Provides-Extra: dev
+Requires-Dist: build>=1.6.1; extra == "dev"
+Requires-Dist: pytest>=9.1.1; extra == "dev"
+Requires-Dist: pytest-asyncio>=1.4.0; extra == "dev"
+Requires-Dist: ruff>=0.17.1; extra == "dev"
+Requires-Dist: twine>=7.0.0; extra == "dev"
+Dynamic: license-file
+
+# llmswitch
+
+One Python client for chat completions and embeddings across OpenAI, Azure OpenAI,
+Azure AI Foundry, Anthropic and Vertex AI. Switch providers by changing the constructor
+arguments; the call sites stay the same.
+
+Supported in 0.1.0: synchronous and asynchronous chat completions (including streaming and
+structured output) and embeddings.
+
+## Installation
+
+```bash
+pip install llmswitch-sdk                  # core: OpenAI and Azure OpenAI
+pip install "llmswitch-sdk[anthropic]"       # adds Anthropic
+pip install "llmswitch-sdk[azure-foundry]"   # adds Azure AI Foundry
+pip install "llmswitch-sdk[vertexai]"        # adds Vertex AI
+pip install "llmswitch-sdk[all]"             # every provider
+```
+
+Requires Python 3.11 or later.
+
+## Quick start
+
+```python
+from llmswitch import LLMSwitch
+
+client = LLMSwitch(provider="openai", api_key="sk-...", model="gpt-4o")
+
+reply = client.chat.completions.create(
+    messages=[{"role": "user", "content": "Say hello in French."}],
+)
+print(reply.choices[0].message.content)
+
+vectors = client.embeddings.create(["first text", "second text"], model="text-embedding-3-small")
+print(len(vectors.data), len(vectors.data[0].embedding))
+```
+
+Async:
+
+```python
+import asyncio
+from llmswitch import AsyncLLMSwitch
+
+async def main():
+    async with AsyncLLMSwitch(provider="anthropic", api_key="sk-ant-...", model="claude-opus-4-5") as client:
+        reply = await client.chat.completions.create(
+            messages=[{"role": "user", "content": "Hello"}],
+        )
+        print(reply.choices[0].message.content)
+
+asyncio.run(main())
+```
+
+Streaming returns an iterator of chunks:
+
+```python
+for chunk in client.chat.completions.create(messages=messages, stream=True):
+    if chunk.choices and chunk.choices[0].delta.content:
+        print(chunk.choices[0].delta.content, end="")
+```
+
+With `AsyncLLMSwitch`, await the call first, then iterate with `async for`:
+
+```python
+stream = await client.chat.completions.create(messages=messages, stream=True)
+async for chunk in stream:
+    if chunk.choices and chunk.choices[0].delta.content:
+        print(chunk.choices[0].delta.content, end="")
+```
+
+Structured output takes a Pydantic model class:
+
+```python
+from pydantic import BaseModel
+
+class City(BaseModel):
+    name: str
+    country: str
+
+parsed = client.chat.completions.parse(
+    messages=[{"role": "user", "content": "Largest city in Japan?"}],
+    response_format=City,
+)
+print(parsed.choices[0].message.parsed)
+```
+
+## Providers
+
+| `provider` | Required settings | Chat (sync / async) | Embeddings |
+|---|---|---|---|
+| `openai` | `api_key` | yes / yes | yes |
+| `azure_openai` | `api_key`, `endpoint`, `api_version`, `deployment_name` | yes / yes | yes |
+| `azure_foundry` | `api_key`, `endpoint`, `api_version`, `deployment_name` | yes / yes | yes |
+| `anthropic` | `api_key` | yes / yes | no |
+| `vertexai` | `location`, `credentials_path` | yes / no | no |
+
+Optional settings: `timeout` (seconds) for every provider; `endpoint`, `organization` and
+`project` for `openai`; `endpoint` and `enable_prompt_caching` (default `True`) for `anthropic`;
+`scopes` for `vertexai`.
+
+Azure OpenAI example:
+
+```python
+client = LLMSwitch(
+    provider="azure_openai",
+    api_key="...",
+    endpoint="https://your-resource.openai.azure.com/",
+    api_version="2024-10-21",
+    deployment_name="your-gpt4o-deployment",
+)
+```
+
+When `deployment_name` is set it is always used as the model. A per-call `model` argument
+only overrides the configured model when no deployment is configured.
+
+Vertex AI example:
+
+```python
+client = LLMSwitch(
+    provider="vertexai",
+    location="us-central1",
+    credentials_path="/path/to/service_account.json",
+    model="gemini-2.5-pro",
+)
+```
+
+Credentials are never read from the environment or from `.env` files by the library. Load
+them in your application and pass them to the constructor.
+
+## Native SDK options
+
+Pass extra arguments for the provider's native client with `client_options`. They are
+given to the SDK client constructor as keyword arguments:
+
+```python
+client = LLMSwitch(
+    provider="openai",
+    api_key="sk-...",
+    model="gpt-4o",
+    client_options={"max_retries": 3, "default_headers": {"X-Team": "search"}},
+)
+```
+
+Options that the unified constructor sets itself are rejected with a `ConfigurationError`:
+`api_key`, `api_version`, `azure_endpoint`, `azure_deployment`, `base_url`, `endpoint`,
+`organization`, `project`, `timeout`, `credential`, `credentials`, `location`, `vertexai`
+and `http_options`. Use the unified argument for those instead.
+
+Per-call keyword arguments are passed to the provider request unchanged, so provider-specific
+parameters such as `seed`, `top_k` or `extra_body` can be given on `create()`.
+
+## Errors
+
+All errors derive from `LLMSwitchError`:
+
+- `ConfigurationError`: invalid or missing constructor settings.
+- `ChatCompletionError`, `EmbeddingGenerationError`: provider failures. `status_code` carries the HTTP status when known.
+- `AuthenticationError`, `APIConnectionError`, `RateLimitExceededError`, `TimeOutError`, `ContentFilterError`, `ModelNotFoundError`, `InvalidResponseError`.
+
+Calling an operation a provider does not support (for example embeddings on `anthropic`)
+raises `LLMSwitchError` before any request is sent.
+
+## Development
+
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[all,dev]"
+pytest
+ruff check src tests
+```
+
+The tests use mocks and do not contact any provider. Live tests are not part of 0.1.0.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

llmswitch_sdk-0.1.0/README.md

@@ -0,0 +1,176 @@
+# llmswitch
+
+One Python client for chat completions and embeddings across OpenAI, Azure OpenAI,
+Azure AI Foundry, Anthropic and Vertex AI. Switch providers by changing the constructor
+arguments; the call sites stay the same.
+
+Supported in 0.1.0: synchronous and asynchronous chat completions (including streaming and
+structured output) and embeddings.
+
+## Installation
+
+```bash
+pip install llmswitch-sdk                  # core: OpenAI and Azure OpenAI
+pip install "llmswitch-sdk[anthropic]"       # adds Anthropic
+pip install "llmswitch-sdk[azure-foundry]"   # adds Azure AI Foundry
+pip install "llmswitch-sdk[vertexai]"        # adds Vertex AI
+pip install "llmswitch-sdk[all]"             # every provider
+```
+
+Requires Python 3.11 or later.
+
+## Quick start
+
+```python
+from llmswitch import LLMSwitch
+
+client = LLMSwitch(provider="openai", api_key="sk-...", model="gpt-4o")
+
+reply = client.chat.completions.create(
+    messages=[{"role": "user", "content": "Say hello in French."}],
+)
+print(reply.choices[0].message.content)
+
+vectors = client.embeddings.create(["first text", "second text"], model="text-embedding-3-small")
+print(len(vectors.data), len(vectors.data[0].embedding))
+```
+
+Async:
+
+```python
+import asyncio
+from llmswitch import AsyncLLMSwitch
+
+async def main():
+    async with AsyncLLMSwitch(provider="anthropic", api_key="sk-ant-...", model="claude-opus-4-5") as client:
+        reply = await client.chat.completions.create(
+            messages=[{"role": "user", "content": "Hello"}],
+        )
+        print(reply.choices[0].message.content)
+
+asyncio.run(main())
+```
+
+Streaming returns an iterator of chunks:
+
+```python
+for chunk in client.chat.completions.create(messages=messages, stream=True):
+    if chunk.choices and chunk.choices[0].delta.content:
+        print(chunk.choices[0].delta.content, end="")
+```
+
+With `AsyncLLMSwitch`, await the call first, then iterate with `async for`:
+
+```python
+stream = await client.chat.completions.create(messages=messages, stream=True)
+async for chunk in stream:
+    if chunk.choices and chunk.choices[0].delta.content:
+        print(chunk.choices[0].delta.content, end="")
+```
+
+Structured output takes a Pydantic model class:
+
+```python
+from pydantic import BaseModel
+
+class City(BaseModel):
+    name: str
+    country: str
+
+parsed = client.chat.completions.parse(
+    messages=[{"role": "user", "content": "Largest city in Japan?"}],
+    response_format=City,
+)
+print(parsed.choices[0].message.parsed)
+```
+
+## Providers
+
+| `provider` | Required settings | Chat (sync / async) | Embeddings |
+|---|---|---|---|
+| `openai` | `api_key` | yes / yes | yes |
+| `azure_openai` | `api_key`, `endpoint`, `api_version`, `deployment_name` | yes / yes | yes |
+| `azure_foundry` | `api_key`, `endpoint`, `api_version`, `deployment_name` | yes / yes | yes |
+| `anthropic` | `api_key` | yes / yes | no |
+| `vertexai` | `location`, `credentials_path` | yes / no | no |
+
+Optional settings: `timeout` (seconds) for every provider; `endpoint`, `organization` and
+`project` for `openai`; `endpoint` and `enable_prompt_caching` (default `True`) for `anthropic`;
+`scopes` for `vertexai`.
+
+Azure OpenAI example:
+
+```python
+client = LLMSwitch(
+    provider="azure_openai",
+    api_key="...",
+    endpoint="https://your-resource.openai.azure.com/",
+    api_version="2024-10-21",
+    deployment_name="your-gpt4o-deployment",
+)
+```
+
+When `deployment_name` is set it is always used as the model. A per-call `model` argument
+only overrides the configured model when no deployment is configured.
+
+Vertex AI example:
+
+```python
+client = LLMSwitch(
+    provider="vertexai",
+    location="us-central1",
+    credentials_path="/path/to/service_account.json",
+    model="gemini-2.5-pro",
+)
+```
+
+Credentials are never read from the environment or from `.env` files by the library. Load
+them in your application and pass them to the constructor.
+
+## Native SDK options
+
+Pass extra arguments for the provider's native client with `client_options`. They are
+given to the SDK client constructor as keyword arguments:
+
+```python
+client = LLMSwitch(
+    provider="openai",
+    api_key="sk-...",
+    model="gpt-4o",
+    client_options={"max_retries": 3, "default_headers": {"X-Team": "search"}},
+)
+```
+
+Options that the unified constructor sets itself are rejected with a `ConfigurationError`:
+`api_key`, `api_version`, `azure_endpoint`, `azure_deployment`, `base_url`, `endpoint`,
+`organization`, `project`, `timeout`, `credential`, `credentials`, `location`, `vertexai`
+and `http_options`. Use the unified argument for those instead.
+
+Per-call keyword arguments are passed to the provider request unchanged, so provider-specific
+parameters such as `seed`, `top_k` or `extra_body` can be given on `create()`.
+
+## Errors
+
+All errors derive from `LLMSwitchError`:
+
+- `ConfigurationError`: invalid or missing constructor settings.
+- `ChatCompletionError`, `EmbeddingGenerationError`: provider failures. `status_code` carries the HTTP status when known.
+- `AuthenticationError`, `APIConnectionError`, `RateLimitExceededError`, `TimeOutError`, `ContentFilterError`, `ModelNotFoundError`, `InvalidResponseError`.
+
+Calling an operation a provider does not support (for example embeddings on `anthropic`)
+raises `LLMSwitchError` before any request is sent.
+
+## Development
+
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[all,dev]"
+pytest
+ruff check src tests
+```
+
+The tests use mocks and do not contact any provider. Live tests are not part of 0.1.0.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

llmswitch_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,74 @@
+[build-system]
+requires = ["setuptools>=84.2.1"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "llmswitch-sdk"
+version = "0.1.0"
+description = "One Python client for chat completions and embeddings across OpenAI, Azure OpenAI, Azure AI Foundry, Anthropic and Vertex AI."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+authors = [{ name = "Rituraj Raman" }]
+keywords = ["llm", "openai", "azure", "anthropic", "vertex-ai", "embeddings", "chat-completions"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
+]
+
+dependencies = [
+    "pydantic>=2.14.1,<3",
+    "openai>=3.36.1,<4.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/RITURAJRAMAN/llmswitch"
+Repository = "https://github.com/RITURAJRAMAN/llmswitch"
+Issues = "https://github.com/RITURAJRAMAN/llmswitch/issues"
+Changelog = "https://github.com/RITURAJRAMAN/llmswitch/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+anthropic = [
+    "anthropic>=2.1.0,<3",
+]
+azure-foundry = [
+    "azure-ai-inference==1.0.0b9",
+    "aiohttp>=3.14.5,<4.0.0",
+]
+vertexai = [
+    "google-genai>=2.32.0,<3",
+]
+all = [
+    "llmswitch-sdk[anthropic,azure-foundry,vertexai]",
+]
+dev = [
+    "build>=1.6.1",
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+    "ruff>=0.17.1",
+    "twine>=7.0.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["llmswitch*"]
+
+[tool.setuptools.package-data]
+llmswitch = ["py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+src = ["src"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B"]
+ignore = ["E501"]

llmswitch_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

llmswitch_sdk-0.1.0/src/llmswitch/__init__.py

@@ -0,0 +1,47 @@
+"""
+llmswitch
+
+One client interface for chat completions and embeddings across OpenAI, Azure
+OpenAI, Azure AI Foundry, Anthropic and Vertex AI.
+
+    from llmswitch import LLMSwitch
+"""
+import logging
+
+__version__ = "0.1.0"
+
+logging.getLogger(__name__).addHandler(logging.NullHandler())
+
+from .core import AsyncLLMSwitch, LLMSwitch  # noqa: E402
+from .errors import (  # noqa: E402
+    APIConnectionError,
+    AuthenticationError,
+    ChatCompletionError,
+    ConfigurationError,
+    ContentFilterError,
+    EmbeddingGenerationError,
+    InvalidResponseError,
+    LLMSwitchError,
+    ModelNotFoundError,
+    RateLimitExceededError,
+    TimeOutError,
+)
+from .models import ProviderExtensions  # noqa: E402
+
+__all__ = [
+    "__version__",
+    "LLMSwitch",
+    "AsyncLLMSwitch",
+    "LLMSwitchError",
+    "ConfigurationError",
+    "ModelNotFoundError",
+    "APIConnectionError",
+    "AuthenticationError",
+    "RateLimitExceededError",
+    "ChatCompletionError",
+    "EmbeddingGenerationError",
+    "InvalidResponseError",
+    "ContentFilterError",
+    "TimeOutError",
+    "ProviderExtensions",
+]

llmswitch_sdk-0.1.0/src/llmswitch/base.py

@@ -0,0 +1,39 @@
+from abc import ABC, abstractmethod
+
+
+class BaseChatProvider(ABC):
+    """
+    Abstract base class for chat providers.
+    """
+
+    @abstractmethod
+    def create(self, messages, **kwargs):
+        """
+        Create a chat completion.
+
+        Args:
+            messages: List of message dicts or objects.
+            **kwargs: Additional parameters for provider.
+
+        Returns:
+            ChatCompletion or generator of ChatCompletionChunk.
+        """
+
+
+class BaseEmbeddingProvider(ABC):
+    """
+    Abstract base class for embedding providers.
+    """
+
+    @abstractmethod
+    def create(self, inputs, **kwargs):
+        """
+        Create embeddings for the given inputs.
+
+        Args:
+            inputs: List of input strings or objects.
+            **kwargs: Additional parameters for provider.
+
+        Returns:
+            Embedding response object.
+        """

llmswitch_sdk-0.1.0/src/llmswitch/config.py

@@ -0,0 +1,115 @@
+"""
+config.py
+
+Pydantic configuration models, one per supported provider. ``CONFIG_REGISTRY``
+maps each provider name to its configuration class.
+"""
+
+from typing import Any, Optional
+
+from pydantic import BaseModel, ConfigDict, Field, ValidationInfo, field_validator
+
+# Native-SDK client arguments that the unified constructor sets itself. They cannot
+# be overridden through ``client_options``; pass them as the unified arguments instead.
+RESERVED_CLIENT_OPTIONS = frozenset({
+    "api_key", "api_version", "azure_endpoint", "azure_deployment", "base_url", "endpoint",
+    "organization", "project", "timeout", "credential", "credentials", "location",
+    "vertexai", "http_options",
+})
+
+
+class BaseLLMConfig(BaseModel):
+    """Fields shared by every provider. Provider configs inherit from this class."""
+
+    # The unified constructor accepts the union of provider-specific fields;
+    # each provider reads what it needs and ignores the rest.
+    model_config = ConfigDict(extra="allow", str_strip_whitespace=True)
+
+    provider: str = Field(..., min_length=1, description="Provider name (openai, azure_openai, ...)")
+    model: Optional[str] = Field(default=None, description="Model name or ID")
+    deployment_name: Optional[str] = Field(
+        default=None,
+        description="Deployment or model alias; when set it takes precedence over the per-call model",
+    )
+    timeout: Optional[float] = Field(default=None, gt=0, allow_inf_nan=False,
+                                     description="Request timeout in seconds")
+    client_options: Optional[dict[str, Any]] = Field(
+        default=None,
+        description="Extra keyword arguments passed to the native SDK client constructor, "
+                    "for example default_headers or max_retries",
+    )
+
+    @field_validator("client_options")
+    @classmethod
+    def reject_reserved_client_options(cls, value: Optional[dict[str, Any]]) -> Optional[dict[str, Any]]:
+        if value is None:
+            return None
+        reserved = sorted(RESERVED_CLIENT_OPTIONS.intersection(value))
+        if reserved:
+            raise ValueError(
+                f"client_options cannot set {', '.join(reserved)}; use the unified constructor arguments instead"
+            )
+        return value
+
+    @field_validator("provider", mode="before")
+    @classmethod
+    def required_string_fields(cls, v, info: ValidationInfo):
+        if v is None or (isinstance(v, str) and not v.strip()):
+            raise ValueError(f"{info.field_name} is required and cannot be empty")
+        return v
+
+
+class AzureOpenAIConfig(BaseLLMConfig):
+    """Azure OpenAI: API key, endpoint, API version and deployment name are required."""
+
+    api_key: str = Field(..., min_length=1, description="API key for authentication")
+    endpoint: str = Field(..., min_length=1, description="Azure OpenAI resource endpoint")
+    api_version: str = Field(..., min_length=1, description="Azure OpenAI API version")
+    deployment_name: str = Field(..., min_length=1, description="Azure OpenAI deployment name")
+
+
+class AzureFoundryConfig(BaseLLMConfig):
+    """Azure AI Foundry: API key, endpoint, API version and deployment name are required."""
+
+    api_key: str = Field(..., min_length=1, description="API key for authentication")
+    endpoint: str = Field(..., min_length=1, description="Azure AI Foundry endpoint")
+    deployment_name: str = Field(..., min_length=1, description="Deployment or model name")
+    api_version: str = Field(..., min_length=1, description="Azure AI Foundry API version")
+
+
+class VertexAIConfig(BaseLLMConfig):
+    """Vertex AI: location and service-account credentials are required."""
+
+    location: str = Field(..., min_length=1, description="GCP location (e.g. us-central1)")
+    credentials_path: str = Field(..., min_length=1, description="Path to GCP credentials JSON file")
+    scopes: list[str] = Field(default_factory=lambda: ["https://www.googleapis.com/auth/cloud-platform"],
+                              description="OAuth scopes for GCP authentication")
+
+
+class OpenAIConfig(BaseLLMConfig):
+    """Native OpenAI: API key is required; endpoint, organization and project are optional."""
+
+    api_key: str = Field(..., min_length=1, description="OpenAI API key")
+    endpoint: Optional[str] = Field(default=None, description="Custom base URL for compatible APIs")
+    organization: Optional[str] = Field(default=None, description="OpenAI organization ID")
+    project: Optional[str] = Field(default=None, description="OpenAI project ID")
+
+
+class AnthropicConfig(BaseLLMConfig):
+    """Anthropic (Claude): API key is required. Prompt caching is on by default."""
+
+    api_key: str = Field(..., min_length=1, description="Anthropic API key")
+    endpoint: Optional[str] = Field(default=None, description="Custom base URL for an Anthropic-compatible gateway")
+    enable_prompt_caching: bool = Field(
+        default=True,
+        description="Inject cache_control on system messages and tool definitions",
+    )
+
+
+CONFIG_REGISTRY = {
+    "azure_openai": AzureOpenAIConfig,
+    "azure_foundry": AzureFoundryConfig,
+    "vertexai": VertexAIConfig,
+    "openai": OpenAIConfig,
+    "anthropic": AnthropicConfig,
+}