claritty-sdk 2.0.0

Official SDK for building apps on the Claritty Platform

claritty-sdk

Official Python SDK for building apps on the Claritty Platform.

Generated apps deployed on Claritty automatically get a CLARITTY_PLATFORM_URL and CLARITTY_AUTH_TOKEN injected at runtime. The SDK reads those env vars and routes all LLM calls through the platform proxy — metering them against the app owner's plan, supporting BYOK (bring-your-own-key) when configured.

Installation

pip install claritty-sdk

Quick start

from claritty_sdk.llm import get_llm_client

client = get_llm_client("claude-sonnet-4-6")
result = client.chat([{"role": "user", "content": "Explain quantum computing"}])
print(result.content)

Streaming:

for delta in client.chat_stream(messages=[
    {"role": "user", "content": "Write me a haiku about kubernetes"}
]):
    print(delta, end="", flush=True)

Wire format

The proxy speaks OpenAI Chat Completions, so you can also point the official openai Python package at ${CLARITTY_PLATFORM_URL}/api/v1 if you want a drop-in replacement. The surface here just gives you sensible Python defaults (env-var auto-config, dict messages, generator-based streaming).

License

MIT