How to use FastAPI with uv and src-layout?

[brainbytes42]

First Check

• I added a very descriptive title here.
• I used the GitHub search to find a similar question and didn't find it.
• I searched in the documentation/README.
• I already searched in Google "How to do X" and didn't find any information.
• I already read and followed all the tutorial in the docs/README and didn't find an answer.

Commit to Help

• I commit to help with one of those options 👆

Example Code

## File-Structure #############################################
foo
 \- src
     \- foo
         \- __init__.py
         \- main.py
 \- pyproject.toml


## pyproject.toml #############################################
[project]
name = "foo"
version = "0.1.0"
description = "Add your description here"
requires-python = ">=3.14"
dependencies = [
    "fastapi[standard]>=0.123.5",
]

[build-system]
requires = ["uv_build>=0.9.14,<0.10.0"]
build-backend = "uv_build"


## main.py ####################################################
from fastapi import FastAPI

print("Hello from foo!")

app = FastAPI()

@app.get("/")
async def root():
    return {"message": "Hello World"}



## Run script with uv #########################################
> uv run -m foo.main         # prints "Hello from foo!"
> uv run fastapi dev src/foo/main.py       # runs the server, but needs "src"

Description

I generally use uv as package manager and build-tool und src-layout for better testability.
To run a simple module, I'd do uv run -m foo.main as shown above - note that the src-folder is not contained in the command, but uv handles the package-import.

Now I try to use FastAPI-CLI in this setup, but I only get it to run with the full path including "src" - which suggests, the script will be run directly and not as an imported package - so the controlled environment usually provided by uv is ignored.

Is there any clean/canonical way to run fastapi-CLI with uv and src-layout?

Thanks!

Operating System

Windows

Operating System Details

Win 11

Python Version

3.14

Additional Context

No response