fastapi-backend-template
FastAPI with PostgreSQL, async SQLAlchemy 2.0, Alembic, and Docker.
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.
| name | fastapi-backend-template |
|---|---|
| description | FastAPI 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