fastapi-backend-template

Eng0AI's avatarfrom Eng0AI

FastAPI with PostgreSQL, async SQLAlchemy 2.0, Alembic, and Docker.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 16, 2025⬇️2downloads

When & Why to Use This Skill

This Claude skill provides a production-ready FastAPI backend template designed to jumpstart web development. It integrates a modern, high-performance tech stack featuring PostgreSQL, asynchronous SQLAlchemy 2.0, and Alembic for database migrations. By offering a pre-configured Docker environment, it ensures architectural consistency and accelerates the transition from local development to scalable cloud deployment.

Use Cases

  • Rapid Prototyping: Quickly bootstrap a high-performance RESTful API with a pre-configured asynchronous database layer.
  • Microservices Architecture: Establish a standardized, containerized base for building and scaling independent backend services.
  • Database Schema Management: Effortlessly handle complex data migrations and version control using the integrated Alembic setup.
  • DevOps Integration: Utilize the provided Docker configuration to ensure seamless environment parity across development, staging, and production.
namefastapi-backend-template
descriptionFastAPI with PostgreSQL, async SQLAlchemy 2.0, Alembic, and Docker.

FastAPI Backend Template

FastAPI with PostgreSQL, async SQLAlchemy 2.0, Alembic migrations, and Docker.

Tech Stack

  • Framework: FastAPI
  • Language: Python
  • ORM: SQLAlchemy 2.0 (async)
  • Migrations: Alembic
  • Database: PostgreSQL

Prerequisites

  • Python 3.11+
  • Docker (recommended)
  • PostgreSQL

Setup

1. Clone the Template

git clone --depth 1 https://github.com/Aeternalis-Ingenium/FastAPI-Backend-Template.git .

If the directory is not empty:

git clone --depth 1 https://github.com/Aeternalis-Ingenium/FastAPI-Backend-Template.git _temp_template
mv _temp_template/* _temp_template/.* . 2>/dev/null || true
rm -rf _temp_template

2. Remove Git History (Optional)

rm -rf .git
git init

3. Setup Virtual Environment

python -m venv venv
source venv/bin/activate  # or venv\Scripts\activate on Windows
pip install -r requirements.txt

4. Setup Database

Configure PostgreSQL and run Alembic migrations.

Development

uvicorn main:app --reload