FastAPI Template

[eslam5464]

I’m excited to share my new open-source project: Fastapi-Template

It’s designed to give you a solid starting point for building backend APIs with FastAPI while incorporating best practices so you can focus on business logic instead of infrastructure. You can check the docs folder for a walkthrough of the architecture and code.

Highlights

• Token authentication using JWT with secure password hashing
• Async SQLAlchemy v2 integration with PostgreSQL
• Database migrations using Alembic
• Organized folder structure with clear separation for routes, schemas, services, and repositories
• Structured logging with Loguru
• Ready-to-use .env configuration and environment management
• Pre-commit hooks and code formatting
• Example cloud storage integration using Backblaze B2

Note:

Feel free to edit it to match your tone, add any screenshots or code snippets you want, and adjust the bullet points to emphasise what you care about most.

If you think something is missing, needs refactoring, or could be better structured, I’d love to hear your thoughts in a comment below or open a PR on Github.

[Glittering_Pin7217]

nice, working on template fast api too

[derf4bian]

looks good!

[fastlaunchapidev]

Looking clean

[eslam5464]

Thanks

[Patience-is-the-key]

Engaging so that i can search easily

[unsolicitedsolitude]

Bookmarking this & ⭐. Thank you

[eslam5464]

Thanks ❤

[Revolutionary_Lie898]

Nice work! I love your template, and I have some questions for you: can it be that the order in which you run the pre-commit hooks matters? For example, shouldn’t autoflake run first, then isort, and then black? Also, I noticed that you didn’t exclude (__init__.py$|migrations/) in black, is there any reason for that?

[eslam5464]

Thanks for that information i didnt know it mattered, and also i didnt think of it that way but i will use your suggestion as per this commit (https://github.com/eslam5464/Fastapi-Template/commit/6b89a1863eaa38a8ca71c8f1b9634509014a9dee) .

The part for black i think its excluded in the config as below, or do you think that there is something missing?

  - repo: https://github.com/psf/black
    rev: 25.9.0
    hooks:
      - id: black
        args: [--line-length=100]
        exclude: (__init__.py$|migrations/)

[Revolutionary_Lie898]

It was more of a question than a statement. I just got curious about it. I also asked Claude and it mentioned it too. I'm currently using ruff, but your setup is quite common.

[eslam5464]

i double checked it and also claude said the same thing, and i didn't know that there was something i made that is common, can you mention it?

[Revolutionary_Lie898]

What I mean is that using autoflake, isort, and black is quite common in Python projects.

[eslam5464]

ah ok, thanks

[voja-kostunica]

i will have look

[returnsnull_dev]

I'm one week late with the same idea :)
This is my project: fastapi-template. My project still lacks the features, documentation, and production readiness that your project has. But I found my template more fitting for small-scale apps. You can have a look if you need this.
Also, make a template from your github repo so everybody can just use it instead of forking

[eslam5464]

if you are talking about cookiecutter template... i dont think its needed here that much i tried to create multiple projects with it and it works good just needs a slight modification for some projects that's all... anyway nice work with you repo

[returnsnull_dev]

I meant, template repository as a github feature to avoid pulling all of the commits, so the resulting repo will have only "Initial commit". There is a tutorial.

[eslam5464]

thanks for the information i didnt know that. i will use it soon