Valstorm Python SDK Guide | Valstorm Docs

The Valstorm Python SDK (valstorm-api) provides a typed, asynchronous and synchronous client library for interacting with the platform.

1. Installation

Install the library using pip or uv:

BASH

pip install valstorm-api

2. Basic Client Initialization

Initialize the client with your access token or API key:

PYTHON

from valstorm_api import ValstormClient

client = ValstormClient(token="your_access_token")

# Query records
contacts = client.records.list(collection_name="contact", limit=10)
for contact in contacts:
    print(f"Contact: {contact.name} ({contact.email})")

3. Advanced Features

Full CRUD batch operations with schema type validation.
Real-time WebSocket subscriptions for notification feeds and telephony events.
Integrated VFS document upload and vector search helpers.