syncopate-runtime 0.1.0

An experimental ASGI runtime built from the ground up.

🎶 Syncopate

An experimental ASGI framework that thrives on the polyrhythmic magic of async Python. This project is built as a learning exercise, so it re-implements all the wheels posible: the asyncio event loop and server, uvicorn HTTP ASGI server and h11 protocol library, and starlette ASGI toolkit. It is not meant for production! Use under your own risk.

📖 Table of Contents

• ⚒ Env Setup and Development
• ⚙ Running Syncopate

⚒ Env Setup and Development

To set up your local environment for development run

make init

This will install all dev requirements using uv and add the pre-commit hooks.

⚙ Running Syncopate

Build an ASGI app:

from syncopate.framework import Syncopate

app = Syncopate()


@app.route("/")
async def index(request):
    return "Hello, World!"


@app.route("/api")
def api(request):
    return {"hello": "world"}

and run it:

import syncopate

syncopate.run(app, host="localhost", port=8888)

This will start the syncopate server and run the app on http://localhost:8888.