antron-model-router 0.1.0__tar.gz

antron_model_router-0.1.0/.gitignore

@@ -0,0 +1,9 @@
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+pretrained_models/
+.env

antron_model_router-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Antron, Inc.
+
+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.

antron_model_router-0.1.0/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.5
+Name: antron-model-router
+Version: 0.1.0
+Summary: A single interface for routing text, vision, image, audio, and video queries across model providers (Anthropic, OpenAI, Gemini, Together, Runware, ElevenLabs, Tripo) and local models.
+Project-URL: Repository, https://github.com/antronai/model-router
+Author: Antron, Inc.
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Requires-Dist: anthropic
+Requires-Dist: elevenlabs
+Requires-Dist: google-genai
+Requires-Dist: json-repair
+Requires-Dist: numpy
+Requires-Dist: openai
+Requires-Dist: pillow
+Requires-Dist: requests
+Requires-Dist: runware
+Requires-Dist: tenacity
+Requires-Dist: together
+Provides-Extra: local
+Requires-Dist: qwen-vl-utils; extra == 'local'
+Requires-Dist: sam3; extra == 'local'
+Requires-Dist: torch; extra == 'local'
+Requires-Dist: transformers>=4.51.3; extra == 'local'
+Provides-Extra: qwen
+Requires-Dist: qwen-vl-utils; extra == 'qwen'
+Requires-Dist: torch; extra == 'qwen'
+Requires-Dist: transformers>=4.51.3; extra == 'qwen'
+Provides-Extra: sam
+Requires-Dist: sam3; extra == 'sam'
+Requires-Dist: torch; extra == 'sam'
+Description-Content-Type: text/markdown
+
+# model-router
+
+A single interface for sending text, vision, image, audio, and video queries to many model providers (Anthropic, OpenAI, Gemini, Together, Runware, ElevenLabs, Tripo), plus local models (Qwen2.5-VL, SAM 3).
+
+## Install
+
+```bash
+uv add antron-model-router
+# with local models
+uv add "antron-model-router[local]"   # or [qwen] / [sam]
+```
+
+The import name is `model_router`.
+
+## Usage
+
+```python
+from model_router.router import ModelRouter
+from model_router.model_interface import Capability
+from model_router.query import Query
+
+router = ModelRouter()
+response = router.get_response(
+    query=Query(query_text="Hello!"),
+    capability=Capability.TEXT,
+    interface_type="anthropic_sonnet45",  # or None to let the router choose
+)
+```
+
+See `src/model_router/demo.py` (`python -m model_router.demo`) for an interactive tour of every interface.
+
+## API keys
+
+Keys are read from environment variables when an interface is first used:
+
+| Provider   | Variable             |
+|------------|----------------------|
+| Anthropic  | `ANTHROPIC_API_KEY`  |
+| OpenAI     | `OPENAI_API_KEY`     |
+| Gemini     | `GEMINI_API_KEY`     |
+| Together   | `TOGETHER_API_KEY`   |
+| Runware    | `RUNWARE_API_KEY`    |
+| ElevenLabs | `ELEVENLABS_API_KEY` |
+| Tripo      | `TRIPO_API_KEY`      |
+
+## Mesh generation
+
+`Capability.MESH_GEN` routes to Tripo H3.1 (`tripo_h31`) by default. Pass a `MeshGenQuery` with text only (text-to-mesh), one image (image-to-mesh), or front/left/back/right views (multiview):
+
+```python
+from model_router.model_interface import Capability, MeshGenQuery
+
+response = router.get_response(
+    query=MeshGenQuery(images={"front": "front.png", "right": "right.png"}, texture=True, pbr=True),
+    capability=Capability.MESH_GEN,
+    interface_type=None,
+)
+glb_url = response["output"]["model_url"]
+```
+
+## Local models
+
+SAM 3 looks for `sam3.pt` in `$MODEL_ROUTER_PRETRAINED_DIR/sam3` (default `./pretrained_models/sam3`), otherwise it downloads from HuggingFace (`facebook/sam3`, gated — run `hf auth login`).
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+```
+
+## License
+
+MIT

antron_model_router-0.1.0/README.md

@@ -0,0 +1,74 @@
+# model-router
+
+A single interface for sending text, vision, image, audio, and video queries to many model providers (Anthropic, OpenAI, Gemini, Together, Runware, ElevenLabs, Tripo), plus local models (Qwen2.5-VL, SAM 3).
+
+## Install
+
+```bash
+uv add antron-model-router
+# with local models
+uv add "antron-model-router[local]"   # or [qwen] / [sam]
+```
+
+The import name is `model_router`.
+
+## Usage
+
+```python
+from model_router.router import ModelRouter
+from model_router.model_interface import Capability
+from model_router.query import Query
+
+router = ModelRouter()
+response = router.get_response(
+    query=Query(query_text="Hello!"),
+    capability=Capability.TEXT,
+    interface_type="anthropic_sonnet45",  # or None to let the router choose
+)
+```
+
+See `src/model_router/demo.py` (`python -m model_router.demo`) for an interactive tour of every interface.
+
+## API keys
+
+Keys are read from environment variables when an interface is first used:
+
+| Provider   | Variable             |
+|------------|----------------------|
+| Anthropic  | `ANTHROPIC_API_KEY`  |
+| OpenAI     | `OPENAI_API_KEY`     |
+| Gemini     | `GEMINI_API_KEY`     |
+| Together   | `TOGETHER_API_KEY`   |
+| Runware    | `RUNWARE_API_KEY`    |
+| ElevenLabs | `ELEVENLABS_API_KEY` |
+| Tripo      | `TRIPO_API_KEY`      |
+
+## Mesh generation
+
+`Capability.MESH_GEN` routes to Tripo H3.1 (`tripo_h31`) by default. Pass a `MeshGenQuery` with text only (text-to-mesh), one image (image-to-mesh), or front/left/back/right views (multiview):
+
+```python
+from model_router.model_interface import Capability, MeshGenQuery
+
+response = router.get_response(
+    query=MeshGenQuery(images={"front": "front.png", "right": "right.png"}, texture=True, pbr=True),
+    capability=Capability.MESH_GEN,
+    interface_type=None,
+)
+glb_url = response["output"]["model_url"]
+```
+
+## Local models
+
+SAM 3 looks for `sam3.pt` in `$MODEL_ROUTER_PRETRAINED_DIR/sam3` (default `./pretrained_models/sam3`), otherwise it downloads from HuggingFace (`facebook/sam3`, gated — run `hf auth login`).
+
+## Development
+
+```bash
+uv sync
+uv run pytest
+```
+
+## License
+
+MIT

antron_model_router-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[project]
+name = "antron-model-router"
+version = "0.1.0"
+description = "A single interface for routing text, vision, image, audio, and video queries across model providers (Anthropic, OpenAI, Gemini, Together, Runware, ElevenLabs, Tripo) and local models."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Antron, Inc." }]
+requires-python = ">=3.11"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "anthropic",
+    "elevenlabs",
+    "google-genai",
+    "json-repair",
+    "numpy",
+    "openai",
+    "Pillow",
+    "requests",
+    "runware",
+    "tenacity",
+    "together",
+]
+
+[project.optional-dependencies]
+qwen = ["torch", "transformers>=4.51.3", "qwen-vl-utils"]
+sam = ["torch", "sam3"]
+local = ["antron-model-router[qwen,sam]"]
+
+[project.urls]
+Repository = "https://github.com/antronai/model-router"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/model_router"]
+
+[dependency-groups]
+dev = ["pytest"]
+
+[tool.pytest.ini_options]
+testpaths = ["src"]
+python_files = ["*_test.py"]

antron_model_router-0.1.0/src/model_router/__init__.py

@@ -0,0 +1,3 @@
+# Copyright (c) 2026 Antron, Inc. Licensed under the MIT License.
+
+"""Model router package for AI model interfaces."""