Quick Start - Nvisy

The Python SDK is in early development. It currently provides a configured HTTP client with authentication, retries, and error handling — typed service methods are not yet available. For full API coverage today, use the TypeScript SDK.

Installation

pip install nvisy-sdk

PyPI Package

View the package on PyPI

Requirements

Python 3.8 or later
An API token from your account settings

Your First Request

from nvisy import Client

client = Client({"api_key": "your-api-token"})

response = client.get_sync("/health/")
print(response)

Configuration

client = Client({
    "api_key": "your-api-token",          # Required
    "base_url": "https://api.nvisy.com",  # Optional
    "timeout": 30.0,                       # Optional: 1.0-300.0 seconds
    "max_retries": 3,                      # Optional: 0-5 attempts
    "user_agent": "MyApp/1.0.0",          # Optional
})

You can also build a client from the environment:

client = Client.from_environment()

Or use the builder:

client = (
    Client.builder()
    .with_api_key("your-api-token")
    .with_timeout(60.0)
    .build()
)

Next Steps

API Reference

Client, configuration, and errors

Examples

Sync and async usage