Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Autonoma Python SDK

Python implementation of the Autonoma Environment Factory SDK.

Package

Package Description
autonoma-ai Core protocol (HMAC, refs, graph, handler, schema)
autonoma-ai[django] Django server handler
autonoma-ai[flask] Flask server adapter
autonoma-ai[fastapi] FastAPI server adapter
autonoma-ai[all] All server adapters

Quick Start

Install

pip install autonoma-ai
# With extras:
pip install "autonoma-ai[fastapi]"
# Or everything:
pip install "autonoma-ai[all]"

FastAPI

from pydantic import BaseModel, ConfigDict
from autonoma.types import HandlerConfig
from autonoma.factory import define_factory
from autonoma_fastapi import create_fastapi_handler

class OrganizationInput(BaseModel):
    model_config = ConfigDict(extra="ignore")
    name: str
    slug: str

def create_org(data, ctx):
    org = db.create_organization(name=data.name, slug=data.slug)
    return {"id": str(org.id), "name": org.name, "slug": org.slug}

def teardown_org(record, ctx):
    db.delete_organization(record["id"])

config = HandlerConfig(
    scope_field="organization_id",
    shared_secret="your-shared-secret",
    signing_secret="your-signing-secret",
    factories={
        "Organization": define_factory(
            create=create_org,
            input_model=OrganizationInput,
            teardown=teardown_org,
        ),
    },
    auth=lambda user, context: {
        "headers": {"Authorization": f"Bearer {create_session_token(user['id'])}"}
    },
)

router = create_fastapi_handler(config)
app.include_router(router, prefix="/api/autonoma")

Commands

poetry install --all-extras   # install with all adapters
poetry run pytest              # run tests

Documentation

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

Release files for autonoma-ai 0.2.10.dev1790406527

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for autonoma-ai 0.2.10.dev1790406527
File Size Uploaded
autonoma_ai-0.2.10.dev1790406527.tar.gz 38.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for autonoma-ai 0.2.10.dev1790406527
File Interpreter ABI Platform
autonoma_ai-0.2.10.dev1790406527-py3-none-any.whl Python 3 none any Details

Total release size: 88.7 kB

Release files / autonoma_ai-0.2.10.dev1790406527.tar.gz

Download URL autonoma_ai-0.2.10.dev1790406527.tar.gz
Size 38.0 kB
Tags Source
SHA-256 checksum
How to use checksums
7887d5904e32ae7d71f1d4024ad0f6f701478b0419ab1b3b8b88cdf7cdd2ffc7
BLAKE2b-256 checksum
How to use checksums
65e559b6b56db85e79d0bc7fa391fd3176c0d1ec23c93778dff17259df2303ca
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 26, 2026.

Transparency log

Release files / autonoma_ai-0.2.10.dev1790406527-py3-none-any.whl

Download URL autonoma_ai-0.2.10.dev1790406527-py3-none-any.whl
Size 50.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1428186375b2d310aa74a9d6f9717060a781304c36ab03bebd75d689bf81614f
BLAKE2b-256 checksum
How to use checksums
cc5d80b38e68dbf200bd35238f09b3e49ba4e4f50607db84e208fffa6976e10c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 26, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.2.9

2 release files

0.2.8

2 release files

0.2.5

2 release files

0.2.0

2 release files

0.1.7

2 release files

0.1.4

2 release files

0.1.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page