Metadata-Version: 2.4
Name: routerbase-client
Version: 0.1.0
Summary: Dependency-free Python client for the RouterBase OpenAI-compatible API.
Project-URL: Homepage, https://routerbase.com
Project-URL: Documentation, https://docs.routerbase.com/
Project-URL: Chat Completions API, https://docs.routerbase.com/api-reference/chat-completions
Project-URL: npm Quickstart, https://www.npmjs.com/package/routerbase-quickstart
Author: RouterBase Contributors
License-Expression: MIT
License-File: LICENSE
Keywords: ai,api-client,llm,openai-compatible,routerbase
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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 :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# RouterBase Python Client

[RouterBase](https://routerbase.com) provides an OpenAI-compatible API for calling many AI models through `https://routerbase.com/v1`.

`routerbase-client` is a small dependency-free Python client for chat completions and model listing. It uses the Python standard library, so it is easy to test in server, CLI, and notebook environments.

## Install

After publishing to PyPI:

```bash
python -m pip install routerbase-client
```

For local testing:

```bash
python -m pip install -e .
```

## Usage

```python
from routerbase import RouterBase

client = RouterBase()
response = client.chat_completion(
    messages=[{"role": "user", "content": "Write a short RouterBase tagline."}]
)
print(response["choices"][0]["message"]["content"])
```

## CLI

```bash
export ROUTERBASE_API_KEY="sk-rb-..."
routerbase-chat "Write a five-word launch tagline"
```

Print the full JSON response:

```bash
routerbase-chat --json "List three product positioning ideas"
```

## Configuration

| Variable | Purpose |
| --- | --- |
| `ROUTERBASE_API_KEY` | RouterBase API key used for requests |
| `ROUTERBASE_BASE_URL` | Optional base URL override; defaults to `https://routerbase.com/v1` |

## Links

- [RouterBase](https://routerbase.com)
- RouterBase docs: https://docs.routerbase.com/
- Chat completions docs: https://docs.routerbase.com/api-reference/chat-completions
- npm quickstart package: https://www.npmjs.com/package/routerbase-quickstart

## License

MIT
