ArchAstro Python SDK

Use the Python SDK to call the ArchAstro Platform API from scripts, CLIs, workers, and async services.

Start Here

1. Install the package.
2. Choose the authentication mode for your process.
3. Verify the token with users.me().
4. Move to the resource-specific API reference when you know the method you need.

uv add archastro-sdk
# or
pip install archastro-sdk

Documentation Map

• Authentication: choose between app user sessions, org-worker tokens, and local/staging base URLs.
• Integration scenarios: smoke-tested snippets for reading the current user, listing teams, and creating an agent.
• Platform API reference: generated reference for the REST client, models, and channel wrappers.
• Phoenix channel reference: lower-level realtime channel client.

Minimal Example

import os

from archastro.platform import PlatformClient

with PlatformClient.with_token(
    os.environ["ARCHASTRO_API_KEY"],
    os.environ["ARCHASTRO_ACCESS_TOKEN"],
) as client:
    me = client.users.me()

print(me.id, me.email)