Skip to main content

Install

pip install aris-sdk

Initialize a client

from aris.client import Aris

client = Aris(
    api_key="sk-aris-your-key",
    registry_url="https://aris-api-production.up.railway.app/",
    timeout=30,
)

Generate text

response = client.generate(
    prompt="Summarize the advantages of distributed inference.",
    model="tinyllama",
    max_tokens=256,
    temperature=0.7,
)

print(response["output"])

Configuration reference

SettingTypeDefaultDescription
api_keystrARIS_API_KEYRegistry-issued API key.
registry_urlstrhttp://localhost:8000Registry base URL.
timeoutint30Request timeout in seconds.
headersdict[str, str]{}Extra headers for custom routing.

Environment variables

VariableDescription
ARIS_API_KEYAPI key for registry authentication.
ARIS_REGISTRY_URLRegistry URL for discovery and handshake.

Async usage

import asyncio
from aris.client import AsyncAris

async def main() -> None:
    client = AsyncAris(api_key="sk-aris-your-key")
    result = await client.generate(prompt="Return a one-line health summary.")
    print(result["output"])

asyncio.run(main())
Move to /advanced-usage for retries, concurrency, and backoff patterns.
Last modified on February 23, 2026