langchain-duel 0.1.0__tar.gz

langchain_duel-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+.venv/
+venv/
+__pycache__/
+*.pyc
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+dist/
+build/
+*.egg-info/
+.coverage

langchain_duel-0.1.0/LICENSE

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

langchain_duel-0.1.0/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: langchain-duel
+Version: 0.1.0
+Summary: An integration package connecting Duel Agents and LangChain
+Project-URL: Homepage, https://duelagents.com
+Project-URL: Source Code, https://github.com/2aronS/Duel-Agents/tree/main/python/langchain-duel
+Project-URL: Release Notes, https://github.com/2aronS/Duel-Agents/releases
+Project-URL: Repository, https://github.com/2aronS/Duel-Agents
+Author: Aaron Shaw
+License: MIT
+License-File: LICENSE
+Keywords: duel-agents,langchain,llm,model-routing,openai
+Requires-Python: >=3.9
+Requires-Dist: langchain-core<0.4,>=0.3.15
+Requires-Dist: langchain-openai<0.4,>=0.2
+Provides-Extra: test
+Requires-Dist: langchain-tests<0.4,>=0.3.5; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'test'
+Requires-Dist: pytest>=7.4; extra == 'test'
+Description-Content-Type: text/markdown
+
+# langchain-duel
+
+This package connects [Duel Agents](https://duelagents.com) to LangChain.
+
+Duel Agents routes each prompt against multiple models and bills the cheapest
+answer that still wins. The proxy is OpenAI wire compatible, so `ChatDuel`
+builds on `langchain-openai` and just points at the Duel proxy with sensible
+defaults.
+
+## Installation
+
+```bash
+pip install -U langchain-duel
+```
+
+Set your Duel API key (create one at
+[duelagents.com/dashboard/settings](https://duelagents.com/dashboard/settings)):
+
+```bash
+export DUEL_API_KEY="duel_<prefix>_<secret>"
+```
+
+## Chat models
+
+```python
+from langchain_duel import ChatDuel
+
+llm = ChatDuel(model="duel-auto", temperature=0)
+print(llm.invoke("Explain concurrent agents in one sentence.").content)
+```
+
+`duel-auto` lets the router pick the model. You can also pass a specific model
+name (for example `gpt-4o-mini` or `claude-3-5-haiku-latest`) and Duel will
+route to that provider.
+
+### Streaming
+
+```python
+for chunk in llm.stream("Write a haiku about routing."):
+    print(chunk.content, end="", flush=True)
+```
+
+### Configuration
+
+| Argument | Env var | Default |
+|----------|---------|---------|
+| `api_key` | `DUEL_API_KEY` | required |
+| `base_url` | `DUEL_PROXY_URL` | `https://duelagents.com/v1` |
+| `model` | - | `duel-auto` |
+
+## License
+
+MIT

langchain_duel-0.1.0/README.md

@@ -0,0 +1,53 @@
+# langchain-duel
+
+This package connects [Duel Agents](https://duelagents.com) to LangChain.
+
+Duel Agents routes each prompt against multiple models and bills the cheapest
+answer that still wins. The proxy is OpenAI wire compatible, so `ChatDuel`
+builds on `langchain-openai` and just points at the Duel proxy with sensible
+defaults.
+
+## Installation
+
+```bash
+pip install -U langchain-duel
+```
+
+Set your Duel API key (create one at
+[duelagents.com/dashboard/settings](https://duelagents.com/dashboard/settings)):
+
+```bash
+export DUEL_API_KEY="duel_<prefix>_<secret>"
+```
+
+## Chat models
+
+```python
+from langchain_duel import ChatDuel
+
+llm = ChatDuel(model="duel-auto", temperature=0)
+print(llm.invoke("Explain concurrent agents in one sentence.").content)
+```
+
+`duel-auto` lets the router pick the model. You can also pass a specific model
+name (for example `gpt-4o-mini` or `claude-3-5-haiku-latest`) and Duel will
+route to that provider.
+
+### Streaming
+
+```python
+for chunk in llm.stream("Write a haiku about routing."):
+    print(chunk.content, end="", flush=True)
+```
+
+### Configuration
+
+| Argument | Env var | Default |
+|----------|---------|---------|
+| `api_key` | `DUEL_API_KEY` | required |
+| `base_url` | `DUEL_PROXY_URL` | `https://duelagents.com/v1` |
+| `model` | - | `duel-auto` |
+
+## License
+
+MIT

langchain_duel-0.1.0/langchain_duel/__init__.py

@@ -0,0 +1,11 @@
+from importlib import metadata
+
+from langchain_duel.chat_models import ChatDuel
+
+try:
+    __version__ = metadata.version(__package__)
+except metadata.PackageNotFoundError:
+    __version__ = ""
+del metadata
+
+__all__ = ["ChatDuel", "__version__"]

langchain_duel-0.1.0/langchain_duel/chat_models.py

@@ -0,0 +1,83 @@
+"""Duel Agents chat model for LangChain."""
+
+from __future__ import annotations
+
+import os
+from typing import Any
+
+from langchain_openai import ChatOpenAI
+from pydantic import model_validator
+
+DUEL_API_BASE = "https://duelagents.com/v1"
+DEFAULT_MODEL = "duel-auto"
+
+
+class ChatDuel(ChatOpenAI):
+    """Duel Agents chat model.
+
+    Routes prompts through the Duel Agents proxy, which runs the request against
+    multiple models and bills the cheapest answer that still wins. The proxy is
+    wire compatible with the OpenAI chat completions API, so this class builds on
+    :class:`~langchain_openai.ChatOpenAI` and only changes the defaults.
+
+    Setup:
+        Install ``langchain-duel`` and set ``DUEL_API_KEY`` (create a key at
+        https://duelagents.com/dashboard/settings).
+
+        .. code-block:: bash
+
+            pip install -U langchain-duel
+            export DUEL_API_KEY="duel_<prefix>_<secret>"
+
+    Key init args:
+        model: str
+            Model routed by Duel. Defaults to ``"duel-auto"`` (auto routing).
+        api_key: Optional[str]
+            Duel API key. Falls back to the ``DUEL_API_KEY`` env var.
+        base_url: Optional[str]
+            Proxy URL. Falls back to ``DUEL_PROXY_URL`` then the public proxy.
+
+    Example:
+        .. code-block:: python
+
+            from langchain_duel import ChatDuel
+
+            llm = ChatDuel(model="duel-auto", temperature=0)
+            llm.invoke("Explain concurrent agents in one sentence.")
+    """
+
+    @property
+    def lc_secrets(self) -> dict[str, str]:
+        return {"openai_api_key": "DUEL_API_KEY"}
+
+    @property
+    def _llm_type(self) -> str:
+        return "duel-chat"
+
+    @classmethod
+    def is_lc_serializable(cls) -> bool:
+        # Third-party namespaces are not registered with the LangChain loader,
+        # so the model is not round-trip serializable.
+        return False
+
+    @model_validator(mode="before")
+    @classmethod
+    def _set_duel_defaults(cls, values: Any) -> Any:
+        if not isinstance(values, dict):
+            return values
+
+        values.setdefault("model", DEFAULT_MODEL)
+        values.setdefault(
+            "base_url", os.getenv("DUEL_PROXY_URL", DUEL_API_BASE)
+        )
+
+        has_key = any(
+            values.get(field)
+            for field in ("api_key", "openai_api_key")
+        )
+        if not has_key:
+            env_key = os.getenv("DUEL_API_KEY")
+            if env_key:
+                values["api_key"] = env_key
+
+        return values

langchain_duel-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "langchain-duel"
+version = "0.1.0"
+description = "An integration package connecting Duel Agents and LangChain"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+authors = [{ name = "Aaron Shaw" }]
+keywords = ["langchain", "duel-agents", "llm", "openai", "model-routing"]
+dependencies = [
+    "langchain-core>=0.3.15,<0.4",
+    "langchain-openai>=0.2,<0.4",
+]
+
+[project.urls]
+Homepage = "https://duelagents.com"
+"Source Code" = "https://github.com/2aronS/Duel-Agents/tree/main/python/langchain-duel"
+"Release Notes" = "https://github.com/2aronS/Duel-Agents/releases"
+Repository = "https://github.com/2aronS/Duel-Agents"
+
+[project.optional-dependencies]
+test = [
+    "pytest>=7.4",
+    "pytest-asyncio>=0.23",
+    "langchain-tests>=0.3.5,<0.4",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["langchain_duel"]
+
+[tool.hatch.build.targets.sdist]
+include = ["langchain_duel", "README.md", "LICENSE"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"