voniai 0.1.0

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
voni = Voni(api_key="your_api_key_here")

# 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.
• 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. Simply provide your API Key during initialization.

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