Heaven is the absolute minimal, insanely fast ASGI web framework for Python purists. It doesn't just get out of your way; it vanishes, leaving you with raw performance and total control.

"Mastery in 10 minutes or less. No grey spots, just pure Python."

1. Stupid Simple: Built for engineers who hate bloat. If you know Python, you already know Heaven.
2. Blazing Fast: A thin layer over ASGI, optimized for high-concurrency and low-latency.
3. Batteries Included (The right ones): Native support for application mounting, centralized hooks (.BEFORE/.AFTER), and powerful background Daemons.
4. Transparent: No magic decorators that hide logic. Just clear, explicit routing.

1. Install

$ pip install heaven

2. Code

from heaven import App, Request, Response, Context

app = App()

# Centralized Auth / Pre-processing
async def auth(req, res, ctx):
    if not req.headers.get('Authorization'):
        res.abort('Unauthorized', status=401)

app.BEFORE('/api/*', auth)

# Simple Handler
async def welcome(req, res, ctx):
    res.body = {"message": "Welcome to Heaven"}

app.GET('/api/v1/welcome', welcome)

3. **Protect** (Automatic OpenAPI)
```python
from heaven import Schema

class User(Schema):
    name: str

app.schema.POST('/user', expects=User, summary="Create User")
app.DOCS('/docs')

4. Fly (CLI) Heaven comes with a beautiful, zero-config CLI.

pip install heaven

# Auto-discovery & run with reload
heaven fly

# Visualize your API structure
heaven routes

5. Daemon (Background)

async def pulse(app):
    print("Heartbeat...")
    return 5 # Run every 5 seconds

app.daemons = pulse

6. Run (Standard)

$ uvicorn app:app --reload

• Full Documentation: https://rayattack.github.io/heaven
• PyPi: https://pypi.org/project/heaven
• Source: Github

We love builders. See the Contribution Guidelines.