Skip to main content
Pre-release

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

Stelvio

PyPI Python Version License

Ship Python to AWS in minutes, not days.

Documentation - Stelvio Manifesto - Roadmap

Stelvio is an open-source framework that lets you build and deploy modern AWS applications using pure Python. Forget YAML, complex configuration, or learning new DSLs.

With the stlv CLI, you focus on your code, and Stelvio handles the infrastructure.

stlv intro video

Why Stelvio?

  • 🐍 Pure Python: Define your infrastructure with standard Python code. Use your favorite IDE, linter, and type checker.
  • 🧠 Smart Defaults: We handle the complex IAM roles, networking, and configuration so you don't have to.
  • 🔗 Automatic Permissions: Simply pass resources to your functions. Stelvio automatically configures permissions and environment variables.
  • ⚡ Live Dev Mode: Run stlv dev to sync your code changes instantly. No waiting for deployments.
  • 🔧 Full Control: Logic and infrastructure in one place, with escape hatches to the underlying Pulumi resources.
  • 📖 Open Source: Built by developers for developers. Apache 2.0 licensed.

Example

Define your infrastructure and application logic in one file. Stelvio handles the wiring.

from stelvio.aws.api_gateway import Api
from stelvio.aws.cron import Cron
from stelvio.aws.dynamo_db import DynamoTable


@app.run
def run() -> None:

    todos = DynamoTable(
        "todos-table",
        fields={
            "user": "string",
            "date": "string"
        },
        sort_key="date",
        partition_key="user"
    )

    cleanup = Cron(
        "cleanup-cron",
        "rate(1 minute)",
        handler="api/handlers.cleanup",
        links=[todos]
    )

    api = Api("stlv-demo-api")
    api.route("GET", "/hello", handler="api/handlers.hello_world")
    api.route("POST", "/todos", handler="api/handlers.post_todo", links=[todos])
    api.route("GET", "/todos/{user}", handler="api/handlers.list_todos", links=[todos])

Supported Components

Stelvio provides high-level components for the most common AWS services:

Give it a try

Open in GitHub Codespaces

Quick Start

You can get up and running in less than 2 minutes.

# 1. Create a new project
uv init my-todo-api && cd my-todo-api

# 2. Add Stelvio
uv add stelvio

# 3. Initialize project structure
uv run stlv init

# 4. Deploy to AWS
uv run stlv deploy

See the Quick Start Guide for a full walkthrough.

Community & Contributing

Stelvio is open source and we welcome contributions!

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Metadata

Release files for stelvio 0.7.0b1

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

Source distribution (sdist)

Source distribution for stelvio 0.7.0b1
File Size Uploaded Provenance Actions
stelvio-0.7.0b1.tar.gz 115.2 kB Without provenance Details for stelvio-0.7.0b1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for stelvio 0.7.0b1
File Interpreter ABI Platform Actions
stelvio-0.7.0b1-py3-none-any.whl Python 3 none any Details for stelvio-0.7.0b1-py3-none-any.whl

Total release size: 264.4 kB

Release files / stelvio-0.7.0b1.tar.gz

Download URL stelvio-0.7.0b1.tar.gz
Size 115.2 kB
Tags Source
SHA-256 checksum
How to use checksums
5a8365e11a09a83b429646abf4fd70b8f7efd5f6e4aa0a4fc65b81eef6ad9a82
BLAKE2b-256 checksum
How to use checksums
2b0d13a69b4c5c98993263a290d903b42f749749b0a4db4e84f36a5211b2dd97
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / stelvio-0.7.0b1-py3-none-any.whl

Download URL stelvio-0.7.0b1-py3-none-any.whl
Size 149.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5849055b737b8c07cb443532d6faa45eb8ba57ca210d68221c3dfb4b06f6062f
BLAKE2b-256 checksum
How to use checksums
02054277db02bf1f7dc6bf9e56ba7fce2d35bb4eb937642c98252730491b2011
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for stelvio 0.7.0b1

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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