runit-sdk 0.1.0

SDK for building apps on RunIt

RunIt SDK

Simple utilities for building FastAPI apps on RunIt.

Installation

The SDK is automatically available in the RunIt runtime. For local development:

pip install -e .

Or install from PyPI (when published):

pip install runit

Quick Start

from fastapi import FastAPI
from runit import context, save_artifact

app = FastAPI()

@app.post("/process")
async def process(data: dict):
    # Access secrets
    api_key = context.get_secret("OPENAI_API_KEY")

    # Access uploaded context
    company = context.get_context("company")

    # Save results
    save_artifact("output.json", json.dumps(result))

    return {"status": "success"}

Features

• Context Access - Read secrets and uploaded JSON data
• Artifact Saving - Write outputs that users can download
• DataFrame Export - Save pandas/polars DataFrames in multiple formats
• Zero Dependencies - Core functionality has no required dependencies

Documentation

See the SDK Guide for complete documentation and examples.

Sample Apps

Check out the sample apps in ../samples/:

• extract-company - URL scraping with artifacts
• image-analysis - File upload and image processing
• bulk-processor - Batch processing with error handling

Development

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run tests with coverage
pytest --cov=runit --cov-report=html

License

MIT