Python SDK

Official Python SDK documentation

Installation

pip install thalosforge-ata

Quick Start

from thalosforge import ATA

ata = ATA(api_key="sk_live_xxxxx")
result = ata.decide(actions=[0, 1, 2])

Client Initialization

from thalosforge import ATA, ATAConfig

ata = ATA(
    api_key="sk_live_xxxxx",        # Or use env var
    api_base="https://api.thalosforge.com/v1",
    timeout=30,
    config=ATAConfig(iter_budget=100)
)

Making Decisions

result = ata.decide(
    actions=[0, 1, 2, 3],
    policy_conf=[0.9, 0.7, 0.5, 0.3],
    belief_val=[0.8, 0.8, 0.8, 0.8],
    planner_val=[0.6, 0.7, 0.8, 0.5],
    safety_ok=True,
    mission_ok=True,
    ethics_ok=True
)

Response Object

result.action_id      # int: Selected action
result.overridden     # bool: Was vetoed?
result.reason_code    # int: Reason code
result.reason_text    # str: Human-readable reason
result.latency_ms     # float: Processing time
result.request_id     # str: Request ID

result.is_success           # True if approved
result.is_safety_override   # True if safety veto

Error Handling

from thalosforge import (
    ATAError,
    AuthenticationError,
    RateLimitError,
    ValidationError
)

try:
    result = ata.decide(actions=[0, 1, 2])
except AuthenticationError:
    print("Invalid API key")
except RateLimitError:
    print("Rate limited")
except ATAError as e:
    print(f"Error: {e}")