Nova ADK (Python)
The official Python SDK for the Nova agentic AI platform — agents, chat, orchestration, voice, billing, and more, over a typed async client.
Install
pip install novalab-adk
Quickstart
import asyncio
from novalab_adk import NovaClient
async def main():
async with NovaClient(api_key="nova_...") as nova:
reply = await nova.chat.send("Summarise the latest sales report")
print(reply.output)
asyncio.run(main())
Usage & consumption
See exactly what your account is spending, split by account type (API vs Workspace) and by operation:
c = await nova.usage.consumption()
print(c.total_credits, "credits across", c.total_events, "requests")
for op in c.by_operation:
print(op.operation, op.product, op.credits)
# Per-request ledger
for ev in await nova.usage.events(limit=20):
print(ev.created_at, ev.operation, ev.credits)
Handling out-of-credits
Billable calls raise NovaInsufficientCreditsError (HTTP 402) with the
details needed to prompt an upgrade or top-up:
from novalab_adk import NovaInsufficientCreditsError
try:
await nova.chat.send("...")
except NovaInsufficientCreditsError as e:
print(f"Out of credits for {e.operation}: balance {e.balance}, cost {e.cost}")
print("Upgrade:", e.upgrade_url)
Documentation
Full docs: https://novalab.build/docs
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file novalab_adk-2.14.0.tar.gz.
File metadata
- Download URL: novalab_adk-2.14.0.tar.gz
- Upload date:
- Size: 80.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cc89a92a624a4e3292ed09776e7f6b03b75e8b23f929ace623122b6e237bbef1
|
|
| MD5 |
e385c30ec5c2e1ab38abe84595fc442c
|
|
| BLAKE2b-256 |
92f4b59c67ef80cf73eec7b0aa8a28650095928a103f4971187fed898b5e6fd3
|
File details
Details for the file novalab_adk-2.14.0-py3-none-any.whl.
File metadata
- Download URL: novalab_adk-2.14.0-py3-none-any.whl
- Upload date:
- Size: 116.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
71989c43f27e4ec39111f05c5b20f2675c38dcc10fab143643d4bf4347e488ad
|
|
| MD5 |
f7b9592e86720a07f0d4625a8420ed0f
|
|
| BLAKE2b-256 |
1f64e00abfc7a164f3cca29134d465880f2477c9fb5ba31c3cbea50c0b30ad12
|
