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

> fastapi new my-app

Description

Description:

It would be great to have a fastapi new command in the FastAPI CLI to quickly scaffold a minimal project structure with a ready-to-run main.py.

Currently, when initializing a new FastAPI project using tools like uv, we have to manually edit main.py file and add the basic boilerplate code (e.g., initializing FastAPI, adding a sample route, etc.) before we can run fastapi dev main.py.

This is a repetitive step that could be automated and would significantly improve developer experience.

Suggested Behavior:

fastapi new my-app

Creates:

my-app/
├── app/
│   └── main.py  # Contains a basic FastAPI app with a root route
├── .gitignore
├── README.md
├── pyproject.toml or requirements.txt

With main.py already set up like this:

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"Hello": "World"}

This would align FastAPI CLI with other popular web frameworks like:

• npx create-next-app@latest
• django-admin startproject
• flask --app app new

Optional Flags (future enhancement ideas):

• --venv: automatically create and activate a virtual environment
• --install: install FastAPI and Uvicorn dependencies
• --package-name: customize the inner package name (default: app)

Let me know if this makes sense — happy to help contribute with an initial implementation as well!

Operating System

Linux

Operating System Details

Ubuntu 24.04 LTS

Python Version

latest

Additional Context

No response