genro-asgi documentation

genro-asgi is a minimal ASGI server core: one instance-isolated server that mounts your applications, routes requests through genro-routes, and grows authentication, sessions, background tasks, OpenAPI and MCP by composition. No globals, no module state — the server is an object you build, run, and throw away.

New here? Start with Getting Started. Coming from another ASGI framework? Read Coming from Starlette / FastAPI. For common questions, see Frequently asked questions.

These pages describe the development checkout. Source and release packages may differ; see Building the documentation for local builds and publication status.

Getting started

• Getting Started
  • What genro-asgi is
  • Installation
  • Hello world
  • Line by line
  • Responding with JSON or HTML
  • The automatic 404
  • The always-present _server app
  • Next steps
• Core Concepts
  • The server / application model
  • Routing with genro-routes
  • Requests and responses
  • Design principles
  • The request flow
  • Where to go next
• Coming from Starlette / FastAPI
  • The mental model, side by side
  • Concept mapping
  • The same endpoint, side by side
  • Honest notes on the differences
  • Where to go next
• Frequently asked questions
  • Installation, mounting and configuration
  • Requests, authentication and plugins
  • WebSockets, worker pools and shared state
• Building the documentation
  • Read the Docs
  • Internals reader

Guides

• How-to Guides
  • The guides
  • How each guide is structured

Architecture

• Architecture overview
  • Core principles
  • The request flow
  • The two layers: server and application
  • The automatic _server application
  • Configuration: the server reads its own
  • WebSockets and the multiworker package
  • Where to go next

API Reference

• API Reference
  • Core
  • Applications
  • Authentication
  • Sessions
  • Middleware
  • Tasks
  • Configuration
  • Channel and communication
  • Storage
  • Plugins
  • WebSocket and WSX
  • Multiworker SPA integration

Indices and tables

• Index

• Module Index

• Search Page