Metadata-Version: 2.4
Name: nimvox-sdk
Version: 1.0.0
Summary: Official Nimvox Platform SDK — a typed async client for the Nimvox API (auth, email, payments, notifications, messaging). Every call is scoped to your project.
License-Expression: Apache-2.0
Project-URL: Homepage, https://nimvox.dev
Project-URL: Repository, https://github.com/nimvox-hq/nimvox-platform
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: httpx>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"
Requires-Dist: pytest-cov>=6.0; extra == "dev"
Requires-Dist: respx>=0.22.0; extra == "dev"
Requires-Dist: mypy>=1.13; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"
Dynamic: license-file

# nimvox-sdk

Official Python SDK for the **Nimvox Platform** API — auth, email, payments, notifications, and messaging — behind one typed async client.

> Built & maintained by **Nimvox** · [github.com/nimvox-hq](https://github.com/nimvox-hq) · [nimvox.dev](https://nimvox.dev)

## Install

```bash
pip install nimvox-sdk
```

## Usage

```python
from nimvox_sdk import NimvoxClient

async with NimvoxClient(project_id="proj_...", api_key="key_...") as client:
    result = await client.auth.register(email="a@b.com", password="secret")
```

`BuildvoxClient` is exported as an alias of `NimvoxClient` — Buildvox is powered by the Nimvox platform:

```python
from nimvox_sdk import BuildvoxClient
```

## Access & security

Your API key is **scoped to your project**. Every method only ever reads or writes your own tenant's data — the gateway cryptographically binds the key to your project, so a key can never reach another tenant. Which services a key may call is governed by your plan: a call to a service you aren't entitled to returns `403`; rate-limit overages return `429`.

## License

Apache-2.0 — the client library is open source and carries an explicit patent grant; the Nimvox service it talks to is proprietary and API-key gated.
