Metadata-Version: 2.4
Name: hiway2llm
Version: 0.0.1a0
Summary: Hiway SDK (Python) — OpenAI-compatible client for the Hiway router. Placeholder, real SDK in public beta.
Project-URL: Homepage, https://www.hiway2llm.com
Project-URL: Documentation, https://www.hiway2llm.com/docs
Project-URL: Repository, https://github.com/hiway2llm/client
Project-URL: Issues, https://github.com/hiway2llm/client/issues
Project-URL: Changelog, https://github.com/hiway2llm/client/releases
Author-email: Mytm-Group <admin@mytm-group.com>
License: MIT
License-File: LICENSE
Keywords: ai,anthropic,cost-optimization,llm,llm-router,openai,openai-compatible,sdk
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# hiway2llm

> 🚧 **Placeholder package** — the real Python SDK is in public beta.

Official Python SDK for [Hiway](https://www.hiway2llm.com) &mdash; one API, every model, save 60-90%. OpenAI-compatible interface.

## Current status

This package reserves the `hiway2llm` name on PyPI while the SDK stabilizes. Instantiating `Hiway()` currently raises `NotImplementedError`.

## Use the API today (OpenAI-compatible)

The Hiway API is fully OpenAI-compatible. Until this SDK lands, use the `openai` library pointed at `https://api.hiway2llm.com/v1`:

```python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["HIWAY_API_KEY"],
    base_url="https://api.hiway2llm.com/v1",
)

response = client.chat.completions.create(
    model="auto",  # smart routing — Hiway picks the cheapest capable model
    messages=[{"role": "user", "content": "hello"}],
)
print(response.choices[0].message.content)
```

Change two lines, save up to 90%.

## Install (the real thing, when it lands)

```bash
pip install hiway2llm       # v0.1.0+
```

Or with [uv](https://github.com/astral-sh/uv):

```bash
uv add hiway2llm
```

## Links

- [Homepage](https://www.hiway2llm.com)
- [GitHub repo](https://github.com/hiway2llm/client)
- [Docs](https://www.hiway2llm.com/docs)
- [Issues](https://github.com/hiway2llm/client/issues)

## License

MIT
