Runsite Python SDK

Use Runsite services from your Python code — transactional email, object storage, configuration and secrets, with end-user auth coming soon.

runsite.app · Documentation · API Reference · Runsite CLI

What is the Runsite Python SDK?

runsite is a typed Python library that your application imports to use Runsite services at runtime, the same way boto3 is used for AWS. When your code runs on Runsite, the clients configure themselves from environment variables the platform sets for your service, so there is nothing to wire up.

Features

Every client comes in a sync and an async flavour, raises typed errors and retries transient failures.

Install

pip install runsite-sdk              # email + secrets
pip install "runsite-sdk[storage]"   # + object storage (boto3)

or with uv:

uv add runsite-sdk
uv add "runsite-sdk[storage]"

Requires Python 3.10+. The package is installed as runsite-sdk and imported as runsite.

Quick start

import runsite

# Email
runsite.email.send(
    to="user@example.com",
    subject="Welcome aboard",
    html="<p>Thanks for signing up!</p>",
)

# Secrets and configuration
database_url = runsite.secrets.get("DATABASE_URL")

# Object storage
bucket = runsite.storage.bucket()
bucket.upload("avatars/42.png", image_bytes)

Module-level shortcuts use a default client built from the environment. For tests, multiple accounts or async code, create clients explicitly:

from runsite import AsyncEmail

email = AsyncEmail(api_key="...")
await email.send(to="user@example.com", subject="Hi", text="Hello!")

Configuration

Roadmap

• Email: send, status, webhook verification
• Secrets: typed reads, set and delete service variables
• Storage: buckets, objects, access keys
• First release on PyPI
• Auth: end-user authentication

Related

• Runsite CLI: github.com/runsite-platform/runsite-cli
• Public API: docs.runsite.app/api-reference/public-api
• All docs: docs.runsite.app
• Dashboard: runsite.app

License

MIT — see LICENSE.