Metadata-Version: 2.4
Name: beakerai
Version: 0.1.0
Summary: Small utilities for checking OpenAI-compatible API endpoints.
Project-URL: Homepage, https://pypi.org/project/beakerai/
Author: Beaker AI
License-Expression: MIT
License-File: LICENSE
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.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# beakerai

`beakerai` provides a small, dependency-free health check for
OpenAI-compatible API endpoints.

## Install

```bash
pip install beakerai
```

## Python

```python
from beakerai import check_endpoint

status = check_endpoint(
    "https://api.example.com",
    api_key="your-api-key",
)
print(status.ok, status.model_count, status.latency_ms)
```

The checker requests the endpoint's `/v1/models` route and returns a typed
`EndpointStatus`.

## CLI

```bash
BEAKERAI_API_KEY="your-api-key" beakerai https://api.example.com
```

The command prints a JSON result and exits with status `0` when the endpoint
is healthy, or `1` otherwise.
