Install
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
| Setting | Type | Default | Description |
|---|
api_key | str | ARIS_API_KEY | Registry-issued API key. |
registry_url | str | http://localhost:8000 | Registry base URL. |
timeout | int | 30 | Request timeout in seconds. |
headers | dict[str, str] | {} | Extra headers for custom routing. |
Environment variables
| Variable | Description |
|---|
ARIS_API_KEY | API key for registry authentication. |
ARIS_REGISTRY_URL | Registry 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())
Last modified on February 23, 2026