autonoma-ai 0.1.7

Autonoma SDK — automate the Autonoma Environment Factory endpoint

Autonoma Python SDK

Python implementation of the Autonoma Environment Factory SDK.

Package

Package	Description
autonoma-sdk	Core protocol (HMAC, refs, templates, graph, handler)
autonoma-sdk[sqlalchemy]	SQLAlchemy ORM adapter
autonoma-sdk[django]	Django ORM adapter and server handler
autonoma-sdk[flask]	Flask server adapter
autonoma-sdk[fastapi]	FastAPI server adapter
autonoma-sdk[postgres]	PostgreSQL driver (psycopg2)
autonoma-sdk[all]	All adapters and drivers

Quick Start

Install

pip install autonoma-sdk
# With extras:
pip install "autonoma-sdk[sqlalchemy,fastapi]"
# Or everything:
pip install "autonoma-sdk[all]"

FastAPI + SQLAlchemy

from autonoma.handler import handle_request, PROTOCOL_VERSION
from autonoma.types import HandlerConfig, HandlerRequest

config = HandlerConfig(
    shared_secret="your-shared-secret",
    signing_secret="your-signing-secret",
    adapter=my_adapter,
    auth=lambda user: {
        "headers": {"Authorization": f"Bearer {create_session_token(user['id'])}"}
    },
)

@app.post("/api/autonoma")
async def autonoma_endpoint(request: Request):
    body = await request.body()
    headers = dict(request.headers)
    req = HandlerRequest(body=body.decode(), headers=headers)
    result = handle_request(config, req)
    return JSONResponse(content=result.body, status_code=result.status)

Commands

poetry install --all-extras   # install with all adapters
poetry run pytest              # run tests
poetry run pytest -k "sqlalchemy"  # tests matching pattern

Documentation

For protocol-level documentation, see the root protocol/ directory. For runnable examples, see examples/python/.