skaal 0.1.0

Infrastructure as Constraints — write it once, scale it with a word.

Skaal

Infrastructure as Constraints — write your app once, scale it with a word.

Skaal lets you describe your application's storage and compute needs as constraints, then automatically selects the right infrastructure backend (local SQLite, Redis, PostgreSQL, AWS DynamoDB, GCP Firestore, …) that satisfies those constraints for your target environment.

Quickstart

pip install skaal

from skaal import App, Module, storage, compute

class TodoModule(Module):
    @storage(reads_per_sec=100, writes_per_sec=50)
    async def todos(self): ...

    @compute(max_replicas=4)
    async def handle_create(self, item: dict): ...

app = App(modules=[TodoModule()])

# Solve constraints and generate an infrastructure plan
skaal plan --app myapp:app --catalog catalogs/local.toml

# Run locally
skaal run --app myapp:app

Cloud Deployment

# Deploy to AWS
pip install "skaal[aws]"
skaal deploy --app myapp:app --target aws --catalog catalogs/aws.toml

# Deploy to GCP
pip install "skaal[gcp]"
skaal deploy --app myapp:app --target gcp --catalog catalogs/gcp.toml

How It Works

1. Annotate your modules with resource constraints (@storage, @compute, @scale, …)
2. Plan — the Z3 SMT solver picks the cheapest backend satisfying all constraints from your catalog
3. Build — Skaal generates Dockerfiles, Pulumi programs, and handler entrypoints
4. Deploy — push to your cloud or run locally with a single command

Installation

Extra	Installs
skaal	Core (local SQLite + Redis)
skaal[aws]	+ boto3, Pulumi AWS, asyncpg
skaal[gcp]	+ google-cloud-firestore/storage, Cloud SQL connector, Pulumi GCP
skaal[examples]	+ Dash, FastAPI, dash-bootstrap-components

License

GPL-3.0-or-later