Skip to main content

​
Prerequisites

  • Python 3.8+
  • An ARIS API key from Registry Dashboard
  • Outbound access to your registry URL

​
1. Install the SDK

pip install aris-sdk

​
2. Set environment variables

export ARIS_API_KEY="sk-aris-your-key"
export ARIS_REGISTRY_URL="https://aris-api-production.up.railway.app/"

​
3. Send your first request

from aris.client import Aris

client = Aris()

response = client.generate(
    prompt="Explain decentralized AI in one sentence.",
    max_tokens=120,
)

print(response["output"])

​
4. Validate the response

You should receive:
  • output: generated text
  • usage: token and credit usage
  • node: node identifier
401 usually means your API key is missing, malformed, or expired.
402 indicates low credits. Top up balance in the registry dashboard.
503 often indicates no eligible nodes are available for your request.

​
Next steps

SDK reference

Explore full client configuration and runtime options.

Generate endpoint

See argument and response details.
Last modified on February 23, 2026