Metadata-Version: 2.4
Name: hyperrouter-ai
Version: 0.1.0
Summary: HyperRouter AI SDK — OpenAI-compatible client for 300+ AI models
License-Expression: MIT
Project-URL: Homepage, https://hyperrouter.ai
Project-URL: Documentation, https://hyperrouter.ai/docs
Keywords: ai,llm,openai,hyperrouter,api,models
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: openai>=1.0.0

# hyperrouter

Python SDK for [HyperRouter](https://hyperrouter.ai) — access 300+ AI models from 50+ providers with a single API key.

## Install

```bash
pip install hyperrouter-ai
```

## Usage

```python
from hyperrouter import HyperRouter

client = HyperRouter(api_key="mr-your-key-here")
# Or set HYPERROUTER_API_KEY env var and call HyperRouter()

response = client.chat.completions.create(
    model="anthropic/claude-sonnet-4",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)
```

## Async

```python
from hyperrouter import AsyncHyperRouter
import asyncio

client = AsyncHyperRouter()

async def main():
    response = await client.chat.completions.create(
        model="openai/gpt-4o",
        messages=[{"role": "user", "content": "Hello!"}],
    )
    print(response.choices[0].message.content)

asyncio.run(main())
```

## OpenAI Compatible

HyperRouter is fully compatible with the OpenAI SDK. You can also use it directly:

```python
from openai import OpenAI

client = OpenAI(
    api_key="mr-your-key-here",
    base_url="https://api.hyperrouter.ai/v1",
)
```

## Links

- [Documentation](https://hyperrouter.ai/docs)
- [Models](https://hyperrouter.ai/models)
- [API Reference](https://hyperrouter.ai/docs#api-reference)
