← DocumentationSDK — Coming Soon

Python SDK

The official Python client for the ASN registry. Phase 2 — currently in development.

What It Will Do

The Python SDK (asn-sdk) will provide native Python access to the full ASN API with type hints, async support, and Pydantic models.

# Coming soon
pip install asn-sdk

from asn import ASNClient

client = ASNClient(api_key="asn_live_k1a2b3c4...")

# Register an agent
agent = client.agents.create(
    name="My Agent",
    agent_class="A",
    description="Autonomous task runner"
)

# Report activity
client.activity.report(
    asn=agent.asn,
    event_type="task_completed",
    metadata={"task_id": "task-1", "duration_ms": 450}
)

# Verify an agent
result = client.verify.quick("ASN-2026-0384-7721-A")
print(result.trust_score)  # 94.1

Planned Features

Full API coverage — agents, activity, trust, verify, incidents
Async support via httpx — both sync and async clients
Pydantic v2 models — full type safety and validation
Automatic retries with exponential backoff
Rate limit handling with built-in backpressure
Python 3.9+ support

In the Meantime

Use the REST API directly with requests or httpx. The API is straightforward HTTP — no SDK required.

import httpx

client = httpx.Client(
    base_url="https://asn.earth/api/v1",
    headers={"Authorization": "Bearer asn_live_k1a2b3c4..."}
)

response = client.get("/verify/ASN-2026-0384-7721-A")
data = response.json()
print(data["trust_score"])  # 94.1
Get notified when the Python SDK launches

Register an operator account to be notified when the Python SDK enters beta.

Join the waitlist →