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.4.0b1

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.4.0-preview.1). PyPI requires PEP 440 versions, so a -preview.N suffix is written as bN: 0.4.0-preview.1 is 0.4.0b1, and 0.4.0-preview.2 will be 0.4.0b2. 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.4.0b1

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.4.0b1
File Size Uploaded Provenance Actions
nerova_sdk-0.4.0b1.tar.gz 41.8 kB With provenance Details for nerova_sdk-0.4.0b1.tar.gz

Built distribution (wheel)

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

Total release size: 197.9 kB

Release files / nerova_sdk-0.4.0b1.tar.gz

Download URL nerova_sdk-0.4.0b1.tar.gz
Size 41.8 kB
Tags Source
SHA-256 checksum
How to use checksums
a8e8de12338d15d8535921cf8312cb907ff935be8d354ea4b326e65c3f874db0
BLAKE2b-256 checksum
How to use checksums
beaaa5306c85c6c8443eafd4ae0f48f905a028b57e84cf12cee7547632854bc3
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 9, 2026.

Transparency log

Release files / nerova_sdk-0.4.0b1-py3-none-any.whl

Download URL nerova_sdk-0.4.0b1-py3-none-any.whl
Size 156.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3d995105ec3b80200965a23a22989bd4bd02596840af580c86fedcc632f87574
BLAKE2b-256 checksum
How to use checksums
440115b07f27e9ef8ecd658aeafa59c4d424d0fa2d390abd071d5c81c4ad3f0a
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 9, 2026.

Transparency log

Security for nerova-sdk 0.4.0b1

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.4.0b1.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 9, 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