Server cannot be started via `python main.py` — missing uvicorn.run() entry point #27

New issue

Closed

opened 2026-05-14 15:12:17 +00:00 by Mark · 1 comment

Mark commented

2026-05-14 15:12:17 +00:00

Owner

Bug

The main.py file defines the FastAPI app but has no if __name__ == "__main__" block to start the server. It must be run externally with:

uvicorn main:app --host 0.0.0.0 --port 8000

This is not documented in the README and the standard python main.py invocation fails silently (logs setup then exits).

Severity

YELLOW Medium — Minor DX issue for developers unfamiliar with FastAPI. Easy to fix by adding an entry point block.

## Bug The `main.py` file defines the FastAPI app but has no `if __name__ == "__main__"` block to start the server. It must be run externally with: ``` uvicorn main:app --host 0.0.0.0 --port 8000 ``` This is not documented in the README and the standard `python main.py` invocation fails silently (logs setup then exits). ## Severity YELLOW **Medium** — Minor DX issue for developers unfamiliar with FastAPI. Easy to fix by adding an entry point block.