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.dev1785916441

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.dev1785916441
File Size Uploaded
autonoma_ai-0.2.10.dev1785916441.tar.gz 38.0 kB Details

Built distribution (wheel)

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

Total release size: 88.7 kB

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

Download URL autonoma_ai-0.2.10.dev1785916441.tar.gz
Size 38.0 kB
Tags Source
SHA-256 checksum
How to use checksums
c699b0881ee78f8718941f37ceb8e0b4aca9e3b4d2479e2334c1fd8421dc58fc
BLAKE2b-256 checksum
How to use checksums
caef1e6b2ff7c547b4aa929f78dd02890b214f8442d19eec6dce033eca0759b9
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 Aug 5, 2026.

Transparency log

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

Download URL autonoma_ai-0.2.10.dev1785916441-py3-none-any.whl
Size 50.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8b1f0b0878060b274e9dd8ff21ec3d6cea977df61c179e2ed5d389ad40c3cb96
BLAKE2b-256 checksum
How to use checksums
fcbfc6621b2021ab0724c5548cc62f615690848cea1668ceac4ee5f995d8c45f
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 Aug 5, 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