Quickstart

Install

uv add oridecon-web

oridecon (core) and oridecon-contracts are pulled in automatically.

Minimal Web API

A single-file prototype with the quickstart app:

from oridecon.web import app, get, singleton


@singleton
class Greeter:
    def hello(self, name: str) -> str:
        return f"Hello, {name}"


@get("/hello/{name}")
async def hello(name: str, greeter: Greeter) -> dict:
    return {"message": greeter.hello(name)}

Run with any ASGI server:

uv run uvicorn main:app

The app object is a standard ASGI application. OpenAPI docs are auto-generated at /docs (Swagger UI) and /redoc.

Production Pattern

Use Application + WebProvider for explicit control:

from oridecon import Application
from oridecon.web import WebProvider


def create_app() -> Application:
    app = Application(name="my-api")
    app.add_provider(WebProvider())
    return app

uv run uvicorn app:create_app --factory

Next Steps

Your First App — the full walkthrough with DI, controllers, and Result types
Guide — mental model, workflows, best practices
How-Tos — task-oriented recipes
Configuration — every config key