voniai 0.1.2

Programmable AI Infrastructure SDK

Voni AI Python SDK

The official Python SDK for the Voniai programmable AI infrastructure.

Installation

pip install voniai

Quick Start (Headless Mode)

from voniai import Voni

# Initialize the client (automatically loads VONI_API_KEY from env)
voni = Voni()

# Send a message to your co-pilot
response = voni.chat.send_message(
    project_id="your_project_id",
    message="How do I integrate Voni?",
    session_id="user_123"
)

print(f"AI Response: {response['message']}")

Features

• Robust Security: Automatic HMAC-SHA256 request signing.
• Environment Support: Automatically loads VONI_API_KEY from environment variables.
• Project Management: Create and configure projects programmatically.
• Headless Chat: Interact with the AI engine directly without using the pre-built widget.
• Webhook Management: Register and manage webhooks for event-driven workflows.

Authentication

Voni uses an API Key + HMAC Signature for all requests. The SDK handles this automatically. You can provide your API Key during initialization or set the VONI_API_KEY environment variable.

# Option 1: Load from environment (Recommended)
voni = Voni()

# Option 2: Explicitly provide key
voni = Voni(api_key="...")

Error Handling

from voniai import Voni, VoniAuthError, VoniApiError

try:
    projects = voni.projects.list()
except VoniAuthError:
    print("Authentication failed. Check your API Key.")
except VoniApiError as e:
    print(f"API returned an error: {e.status_code}")

License

MIT