Home Docs Quick Start

Quick Start

1. Create an Account

Sign up for a free Talos account to get your API credentials. No credit card required.

Tip: The free tier includes 1,000 API calls and 100 code executions per month.

2. Install the SDK

bash
pip install talos-sdk

3. Initialize the Client

Python
from talos import TalosClient

client = TalosClient(
    api_key="your-api-key",
    base_url="https://api.talos.dev"
)

# Test the connection
health = await client.health.check()
if health.status == "ok":
    print("Talos is up")
else:
    print("Talos is down")

4. Make Your First API Call

Python
# Register a new user
user = await client.auth.register(
    email="user@example.com",
    password="secure-password"
)

print(f"User created: {user.id}")

# Login
session = await client.auth.login(
    email="user@example.com",
    password="secure-password"
)

print(f"Access token: {session.access_token[:20]}...")

5. Execute Code

Python
# Submit code for execution
job = await client.execute.submit(
    language="python",
    code="print('Hello, Talos!')",
    timeout=5
)

# Get results
result = await client.execute.get_result(job.id)
print(f"Output: {result.stdout}")
print(f"Status: {result.status}")

Ready to dive deeper?

Explore the full API reference and integration guides.

View Documentation