Metadata-Version: 2.4
Name: llama-index-llms-duel
Version: 0.1.0
Summary: llama-index llms duel agents integration
Project-URL: Homepage, https://duelagents.com
Project-URL: Repository, https://github.com/2aronS/Duel-Agents
Author: Aaron Shaw
License-Expression: MIT
License-File: LICENSE
Keywords: duel,duel-agents,model-routing,openai,router
Requires-Python: <4.0,>=3.10
Requires-Dist: llama-index-core<0.15,>=0.13.0
Requires-Dist: llama-index-llms-openai-like<0.6,>=0.5.0
Description-Content-Type: text/markdown

# LlamaIndex Llms Integration: Duel Agents

[Duel Agents](https://duelagents.com) routes each prompt against multiple
models and bills the cheapest answer that still wins, behind an
OpenAI-compatible proxy.

## Installation

```bash
pip install llama-index-llms-duel
```

Create an API key at
[duelagents.com/dashboard/settings](https://duelagents.com/dashboard/settings)
(an active subscription is required) and set it:

```bash
export DUEL_API_KEY="duel_<prefix>_<secret>"
```

## Usage

```python
from llama_index.llms.duel import DuelLLM

llm = DuelLLM(model="duel-auto")

resp = llm.complete("Explain concurrent agents in one sentence.")
print(resp)
```

Chat:

```python
from llama_index.core.llms import ChatMessage

messages = [
    ChatMessage(role="system", content="You answer concisely."),
    ChatMessage(role="user", content="What is model routing?"),
]
print(llm.chat(messages))
```

`duel-auto` lets Duel pick the model. You can also pass a specific model name
(for example `gpt-4o-mini` or `claude-3-5-haiku-latest`) to route to that
provider.

## License

MIT
