Quick Start

Install the SDK

pip install thalosforge-ata

Get your API key

Go to your Dashboard → API Keys and create a new key. Copy it somewhere safe.

Set your API key

export THALOSFORGE_API_KEY="sk_live_your_key_here"

Make your first decision

from thalosforge import ATA

# Initialize client
ata = ATA()

# Make a decision
result = ata.decide(
    actions=[0, 1, 2, 3],           # Action candidates
    policy_conf=[0.9, 0.7, 0.5, 0.3],  # Confidence scores
    safety_ok=True,                  # Safety constraint
    mission_ok=True,                 # Mission constraint
    ethics_ok=True                   # Ethics constraint
)

# Check result
print(f"Chosen action: {result.action_id}")
print(f"Was overridden: {result.overridden}")
print(f"Reason: {result.reason_text}")

Handle the response

if result.is_success:
    # Action approved - execute it
    execute_action(result.action_id)
else:
    # Action was vetoed
    if result.is_safety_override:
        trigger_emergency_stop()
    else:
        request_human_intervention()