Python SDK

aura-sdk embeds Aura in a Python backend — a service, an API, a worker, a scheduled job — so your users get an answer from the product they already use.

It wraps the public /api/v1 surface with company API-key auth, and is async: every call is a coroutine, so it drops into an existing async service without a thread pool in the middle.

To administer Aura or try a deployment out by hand, use the CLI. There is no Python CLI; the aura command ships from TypeScript only.

Install

pip install aura-sdk

The import package is aura_sdk.

Server-side only

An API key carries your whole company’s access. Read it from the environment or your secret store — never commit it, and never ship it to a client.

Hello, Aura

import asyncio, os
from aura_sdk import AuraClient

async def main() -> None:
    async with AuraClient(api_key=os.environ["AURA_API_KEY"]) as aura:
        project = await aura.create_project(name="vrp demo", from_deployment="acme/vrp")
        reply = await aura.chat(project.id, "Solve this and summarize the result.")
        print(reply.content)

asyncio.run(main())

Where to go next

ConfigurationConstructing the client, closing it, and pointing at another Aura.

ConventionsAsync-only, paging, pydantic models, and how errors are typed.

API referenceEvery export, generated from the package's own docstrings.

Chat with a projectThe dispatch-and-poll contract, and how to stop a turn.