roboto-sai-sdk 0.6.0

Roboto SAI python SDK

roboto-sai-sdk

Python SDK for the Roboto SAI platform — the canonical client and source of truth for public model names, runtime profiles, and the frozen runtime contract.

Install

pip install roboto-sai-sdk

Requires Python 3.10+.

Quick Start

from roboto_sai_sdk import RobotoSAI

client = RobotoSAI()  # uses SAI_API_KEY from env
result = client.send_message("Review this repository and propose the next refactor.")

print(result["model"])      # "roboto-sai"
print(result["subtitle"])   # "Core runtime"
print(result["text"])       # assistant reply

Stream mode:

from roboto_sai_sdk import RobotoSAI

client = RobotoSAI(model="roboto-sai")
for event in client.stream("List five things to test in a new SDK release."):
    delta = ""
    if isinstance(event.data, dict) and event.data.get("type") == "response.output_text.delta":
        delta = event.data.get("delta") or ""
    print(delta, end="", flush=True)

Public Model Surface

The SDK exposes four canonical models:

Model	Mode	Use
roboto-sai	single-agent	Core general intelligence
roboto-sai-code-x	single-agent	Code generation, debugging, architecture
roboto-sai-cortex	multi-agent	Deep orchestration with research capabilities
roboto-sai-rovox	single-agent (audio)	Voice/audio I/O — separate realtime path

Use only canonical roboto-sai-* names. Legacy aliases (e.g. roboto-sai-lightning, -heavy, -flex) were removed in 0.2.0.

Inspect Runtime Profiles

from roboto_sai_sdk import (
    DEFAULT_PUBLIC_MODEL,
    PUBLIC_MODEL_NAMES,
    get_runtime_profile,
)

print(DEFAULT_PUBLIC_MODEL)             # "roboto-sai"
print(sorted(PUBLIC_MODEL_NAMES))       # all 4 names
print(get_runtime_profile("roboto-sai"))

Key Precedence

The SDK resolves API keys in this order:

1. Explicit api_key=... argument
2. SAI_API_KEY environment variable

Set SAI_API_BASE_URL to override the default base URL (https://api.roboto-sai.com/v1).

Public API

The stable surface is roboto_sai_sdk.__all__ (15 names; client, keys, and MCP are lazy-loaded on first access):

RobotoSAI, SendMessageResult, DEFAULT_PUBLIC_MODEL, PUBLIC_MODEL_NAMES, RuntimeProfile, get_runtime_profile, normalize_public_model, get_public_runtime_contract, CONTRACT_VERSION, CONTRACT_LAST_UPDATED, get_mcp_config, SAI_API_KEY, resolve_api_keys, resolve_provider_api_key, hash_key

import roboto_sai_sdk

assert roboto_sai_sdk.__all__ == [
    "RobotoSAI",
    "SendMessageResult",
    "DEFAULT_PUBLIC_MODEL",
    "PUBLIC_MODEL_NAMES",
    "RuntimeProfile",
    "get_runtime_profile",
    "normalize_public_model",
    "get_mcp_config",
    "get_public_runtime_contract",
    "CONTRACT_VERSION",
    "CONTRACT_LAST_UPDATED",
    "SAI_API_KEY",
    "resolve_api_keys",
    "resolve_provider_api_key",
    "hash_key",
]

Voice/audio (roboto-sai-rovox) requires the realtime integration — send_message and stream raise NotImplementedError for that model. A future RobotoSAIVoice client will land in a separate release.

Repository

Source code, examples, and full release notes: https://github.com/Roboto-SAI-LLC/roboto-sai-sdk

License

Proprietary. See LICENSE in the repository.