Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

nerova-sdk

Server-side Python client for Nerova's dedicated stable tenant-v1 API. The typed async client is built from the published tenant-v1 OpenAPI contract, so every path, parameter, and model exists because the contract says so.

This package is server-side only: no browser credential flow, no UI, no persistent credential storage. Never ship an API key to a browser or a mobile app.

pip install nerova-sdk==0.3.0b3

The distribution name is nerova-sdk; the import name is nerova_sdk. It needs Python 3.9 or later and installs its HTTP and serialization runtime libraries as regular dependencies.

Versioning

The SDK shares one version line with @nerova/sdk and Nerova.Sdk (currently 0.3.0-preview.3). PyPI requires PEP 440 versions, so a -preview.N suffix is written as bN: 0.3.0-preview.3 is 0.3.0b3, and 0.3.0-preview.4 will be 0.3.0b4. A stable release keeps the bare X.Y.Z. Pip skips pre-releases unless you pin one (as above) or pass --pre. The API surface may change before 1.0, so pin the exact version.

Quickstart

The API has one public host, https://api.nerovasystems.com, which is the client's default base URL. Every API key is a Live key (nrv_live_) that reaches Production; approved platforms start on a free testing allowance. Read the key from the environment and send it as Authorization: Bearer <key>:

import asyncio
import os

from kiota_abstractions.authentication import ApiKeyAuthenticationProvider, KeyLocation
from kiota_http.httpx_request_adapter import HttpxRequestAdapter
from nerova_sdk import NerovaPartnerClient


async def main() -> None:
    value = os.environ["NEROVA_API_KEY"]
    tenant_id = os.environ["TENANT_ID"]

    authentication_provider = ApiKeyAuthenticationProvider(
        KeyLocation.Header, f"Bearer {value}", "Authorization"
    )
    client = NerovaPartnerClient(HttpxRequestAdapter(authentication_provider))

    manifest = await client.api.v1.tenants.by_tenant_id(tenant_id).activation.manifest.get()
    print(manifest.state, manifest.next_allowed_actions)


asyncio.run(main())

The client mirrors the URL structure of the API: client.api.v1.status, client.api.v1.context, client.api.v1.tenants, and client.api.v1.tenants.by_tenant_id(id) for everything under one tenant. Models live in nerova_sdk.models, and request builders in nerova_sdk.api.

Conventions

  • Idempotency: send a caller-owned Idempotency-Key header on every mutation via the request configuration, and reuse the same value when repeating the same command. The client performs no automatic retries of mutations:

    from kiota_abstractions.base_request_configuration import RequestConfiguration
    from nerova_sdk.models.create_tenant_v1_request import CreateTenantV1Request
    
    configuration = RequestConfiguration()
    configuration.headers.add("Idempotency-Key", "provision-tenant-your-crm-id-123")
    created = await client.api.v1.tenants.post(
        CreateTenantV1Request(display_name="Demo Salon", external_reference="your-crm-id-123"),
        configuration,
    )
    
  • Errors follow RFC 9457 problem details: the request adapter raises the deserialized nerova_sdk.models.problem_details.ProblemDetails (an APIError) with response_status_code and response_headers attached; the stable code and correlationId arrive in additional_data. Branch on those fields, never on message text.

  • Enums are open string sets; treat unknown values as forward compatibility.

  • List endpoints paginate with unixms|id cursors: pass cursor back through the query parameters until next_cursor is None.

Documentation and support

Guides, the API reference, and support contacts are on docs.nerovasystems.com. Start with the quickstart and the SDK overview.

Metadata

Release files for nerova-sdk 0.3.0b3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nerova-sdk 0.3.0b3
File Size Uploaded Provenance Actions
nerova_sdk-0.3.0b3.tar.gz 60.6 kB With provenance Details for nerova_sdk-0.3.0b3.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for nerova-sdk 0.3.0b3
File Interpreter ABI Platform Actions
nerova_sdk-0.3.0b3-py3-none-any.whl Python 3 none any Details for nerova_sdk-0.3.0b3-py3-none-any.whl

Total release size: 315.5 kB

Release files / nerova_sdk-0.3.0b3.tar.gz

Download URL nerova_sdk-0.3.0b3.tar.gz
Size 60.6 kB
Tags Source
SHA-256 checksum
How to use checksums
3c020b1092bd4aac1c1ba4cde475c3241181cc5b4d68320735c119a78a6fea4e
BLAKE2b-256 checksum
How to use checksums
5e8d4426a72865408b24fc445b9762b3b1286e4f75f049bd8c83eac26053b322
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 5, 2026.

Transparency log

Release files / nerova_sdk-0.3.0b3-py3-none-any.whl

Download URL nerova_sdk-0.3.0b3-py3-none-any.whl
Size 254.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
38383b40ccbb3e2a7754c7fede5bbc2aa3de088c743e8e6cd9908210b76f2811
BLAKE2b-256 checksum
How to use checksums
4e19f5fefbbee22d84d7c7474a7dbc6ba0f74cfd74fb5ac5b1a4ce82b4eff402
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 5, 2026.

Transparency log

Security for nerova-sdk 0.3.0b3

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for nerova_sdk-0.3.0b3.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 5, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page