interop-router 0.1.0__tar.gz

interop_router-0.1.0/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.3
+Name: interop-router
+Version: 0.1.0
+Summary: Interoperate between AI providers using the OpenAI Responses API as a common interface.
+Author: David Koleczek
+Author-email: David Koleczek <45405824+DavidKoleczek@users.noreply.github.com>
+Requires-Dist: anthropic>=0.75,<1.0
+Requires-Dist: google-genai>=1.56,<2.0
+Requires-Dist: openai[aiohttp]>=2.14,<3.0
+Requires-Dist: pydantic>=2.12,<3.0
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+<h1 align="center">
+    InteropRouter
+</h1>
+<p align="center">
+    <p align="center">Seamlessly call major LLMs and image generation models through a unified interface.
+    </p>
+</p>
+
+InteropRouter is designed to seamlessly interoperate between the most common AI providers at a high level of quality. 
+It uses the [OpenAI Responses API](https://platform.openai.com/docs/guides/migrate-to-responses) types as a common denominator for inputs and outputs, allowing you to switch between providers with minimal code changes.
+See [examples/](examples/) for detailed notebooks covering interoperability, function calling, image generation, and more.
+
+## Getting Started
+
+### Installation
+
+```bash
+# With uv.
+uv add interop-router
+
+# With pip.
+pip install interop-router
+```
+
+### Usage
+
+```python
+from anthropic import AsyncAnthropic
+from google import genai
+from openai import AsyncOpenAI
+from openai.types.responses import EasyInputMessageParam
+
+from interop_router.router import Router
+from interop_router.types import ChatMessage
+
+router = Router()
+router.register("openai", AsyncOpenAI())
+router.register("gemini", genai.Client())
+router.register("anthropic", AsyncAnthropic())
+
+# InteropRouter is strictly typed, so be sure to use OpenAI's Response types for inputs. 
+# See https://platform.openai.com/docs/guides/migrate-to-responses and the library source for more details on typing.
+messages = [ChatMessage(message=EasyInputMessageParam(role="user", content="Hello!"))]
+
+response = await router.create(input=messages, model="gpt-5.2")
+response = await router.create(input=messages, model="gemini-3-flash-preview")
+response = await router.create(input=messages, model="claude-sonnet-4-5-20250929")
+```
+
+### InteropRouter Design Philosophy
+
+The only goal of InteropRouter is to interoperate between the most common AI providers. To make this goal achievable, we make several trade-offs:
+- Only support OpenAI (including Azure OpenAI), Gemini, and Anthropic. Each provider adds a significant amount of possible permutations of features. To maintain high-quality interoperability, we limit the number of providers.
+- Only support async APIs, but not streaming token by token as this adds significant complexity, and for agents the latency is not as important.
+- We do not support stateful features where possible. These features are contradictory to the goal of seamless swapping between providers.
+- We choose the OpenAI Responses API types as the common denominator for creating pivots between providers. The reason is two-fold: a) The Responses API supports most features b) By picking an existing API, we avoid the need to design and maintain our own schema and Responses API support is gained for "free".
+- The supported features will be rigorously tested to ensure seamless swapping between providers within a single conversation.
+
+
+## Development
+
+### Prerequisites
+
+- [uv](https://docs.astral.sh/uv/getting-started/installation/)
+- [prek](https://github.com/j178/prek/blob/master/README.md#installation)
+
+### Setup
+
+Create uv virtual environment and install dependencies:
+
+```bash
+uv sync --frozen --all-extras --all-groups
+```
+
+Set up git hooks:
+
+```bash
+prek install
+```
+
+To update dependencies (updates the lock file):
+
+```bash
+uv sync --all-extras --all-groups
+```
+
+Run formatting, linting, type checking, and tests in one command:
+
+```bash
+uv run ruff format && uv run ruff check --fix && uv run ty check && uv run pytest
+```
+
+### Further Information
+
+[docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)
+
+
+## Compatibility and Roadmap
+
+[docs/COMPATIBILITY_AND_ROADMAP.md](docs/COMPATIBILITY_AND_ROADMAP.md)

interop_router-0.1.0/README.md

@@ -0,0 +1,100 @@
+<h1 align="center">
+    InteropRouter
+</h1>
+<p align="center">
+    <p align="center">Seamlessly call major LLMs and image generation models through a unified interface.
+    </p>
+</p>
+
+InteropRouter is designed to seamlessly interoperate between the most common AI providers at a high level of quality. 
+It uses the [OpenAI Responses API](https://platform.openai.com/docs/guides/migrate-to-responses) types as a common denominator for inputs and outputs, allowing you to switch between providers with minimal code changes.
+See [examples/](examples/) for detailed notebooks covering interoperability, function calling, image generation, and more.
+
+## Getting Started
+
+### Installation
+
+```bash
+# With uv.
+uv add interop-router
+
+# With pip.
+pip install interop-router
+```
+
+### Usage
+
+```python
+from anthropic import AsyncAnthropic
+from google import genai
+from openai import AsyncOpenAI
+from openai.types.responses import EasyInputMessageParam
+
+from interop_router.router import Router
+from interop_router.types import ChatMessage
+
+router = Router()
+router.register("openai", AsyncOpenAI())
+router.register("gemini", genai.Client())
+router.register("anthropic", AsyncAnthropic())
+
+# InteropRouter is strictly typed, so be sure to use OpenAI's Response types for inputs. 
+# See https://platform.openai.com/docs/guides/migrate-to-responses and the library source for more details on typing.
+messages = [ChatMessage(message=EasyInputMessageParam(role="user", content="Hello!"))]
+
+response = await router.create(input=messages, model="gpt-5.2")
+response = await router.create(input=messages, model="gemini-3-flash-preview")
+response = await router.create(input=messages, model="claude-sonnet-4-5-20250929")
+```
+
+### InteropRouter Design Philosophy
+
+The only goal of InteropRouter is to interoperate between the most common AI providers. To make this goal achievable, we make several trade-offs:
+- Only support OpenAI (including Azure OpenAI), Gemini, and Anthropic. Each provider adds a significant amount of possible permutations of features. To maintain high-quality interoperability, we limit the number of providers.
+- Only support async APIs, but not streaming token by token as this adds significant complexity, and for agents the latency is not as important.
+- We do not support stateful features where possible. These features are contradictory to the goal of seamless swapping between providers.
+- We choose the OpenAI Responses API types as the common denominator for creating pivots between providers. The reason is two-fold: a) The Responses API supports most features b) By picking an existing API, we avoid the need to design and maintain our own schema and Responses API support is gained for "free".
+- The supported features will be rigorously tested to ensure seamless swapping between providers within a single conversation.
+
+
+## Development
+
+### Prerequisites
+
+- [uv](https://docs.astral.sh/uv/getting-started/installation/)
+- [prek](https://github.com/j178/prek/blob/master/README.md#installation)
+
+### Setup
+
+Create uv virtual environment and install dependencies:
+
+```bash
+uv sync --frozen --all-extras --all-groups
+```
+
+Set up git hooks:
+
+```bash
+prek install
+```
+
+To update dependencies (updates the lock file):
+
+```bash
+uv sync --all-extras --all-groups
+```
+
+Run formatting, linting, type checking, and tests in one command:
+
+```bash
+uv run ruff format && uv run ruff check --fix && uv run ty check && uv run pytest
+```
+
+### Further Information
+
+[docs/DEVELOPMENT.md](docs/DEVELOPMENT.md)
+
+
+## Compatibility and Roadmap
+
+[docs/COMPATIBILITY_AND_ROADMAP.md](docs/COMPATIBILITY_AND_ROADMAP.md)

interop_router-0.1.0/pyproject.toml

@@ -0,0 +1,70 @@
+[project]
+name = "interop-router"
+version = "0.1.0"
+description = "Interoperate between AI providers using the OpenAI Responses API as a common interface."
+readme = "README.md"
+authors = [
+    { name = "David Koleczek", email = "45405824+DavidKoleczek@users.noreply.github.com" }
+]
+requires-python = ">=3.11"
+dependencies = [
+    "anthropic>=0.75,<1.0",
+    "google-genai>=1.56,<2.0",
+    "openai[aiohttp]>=2.14,<3.0",
+    "pydantic>=2.12,<3.0",
+]
+
+[build-system]
+requires = ["uv_build>=0.9.15,<0.10.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "ipykernel>=7.1",
+    "nbclient>=0.10",
+    "pytest>=9.0",
+    "pytest-asyncio>=1.3",
+    "ruff>=0.14",
+    "ty>=0.0.5",
+]
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+
+[tool.ruff.lint]
+select = [
+    "F",    # pyflakes
+    "E",    # pycodestyle
+    "I",    # isort
+    "N",    # pep8-naming
+    "UP",   # pyupgrade
+    "RUF",  # ruff
+    "B",    # flake8-bugbear
+    "C4",   # flake8-comprehensions
+    "ISC",  # flake8-implicit-str-concat
+    "PIE",  # flake8-pie
+    "PT",   # flake-pytest-style
+    "PTH",  # flake8-use-pathlib
+    "SIM",  # flake8-simplify
+    "TID",  # flake8-tidy-imports
+]
+ignore = [
+    "E501",   # line-too-long (formatter makes best-effort attempt)
+    # The following rules conflict with the formatter, see: https://docs.astral.sh/ruff/formatter/#conflicting-lint-rules
+    "W191",   # tab-indentation
+    "E111",   # indentation-with-invalid-multiple
+    "E114",   # indentation-with-invalid-multiple-comment
+    "E117",   # over-indented
+    "ISC002", # multi-line-implicit-string-concatenation
+]
+
+[tool.ruff.lint.isort]
+force-sort-within-sections = true
+split-on-trailing-comma = false
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"