First App

Your first application can be very small. The important part is that the application object becomes the single entry point for routes, configuration, and future modules.

Minimal Setup

from autumn import Autumn

import uvicorn

app = Autumn(
    discover = 'app.controllers'
)

if __name__ == '__main__':
    uvicorn.run(app)

Why Start Like This

• Autumn(...) defines a clear application boundary.
• The runtime stays explicit, with no hidden CLI magic.
• When controllers and services appear later, they already have a stable root.

How Other Parts Are Connected

Controllers, services, leaf functions, and hooks must live in imported modules. Use discover to specify the module that contains them. Here, app.controllers connects the controllers package; one module is passed as a string, while several modules can be passed as a tuple or list.

In the next step, we will create the first controller in app/controllers/hello.py. The application assembly remains in main.py.