https://github.com/humblebeeai/rest-fastapi-orm-template
This is a template repository for FastAPI with ORM (SQLAlchemy) projects.
https://github.com/humblebeeai/rest-fastapi-orm-template
boilerplate cicd cookiecutter docker docker-compose fastapi fastapi-boilerplate fastapi-sqlalchemy fastapi-template microservice orm python python3 rest-api software-engineering sqlalchemy template web-server
Last synced: 23 days ago
JSON representation
This is a template repository for FastAPI with ORM (SQLAlchemy) projects.
- Host: GitHub
- URL: https://github.com/humblebeeai/rest-fastapi-orm-template
- Owner: humblebeeai
- License: mit
- Created: 2025-01-08T07:52:40.000Z (over 1 year ago)
- Default Branch: cookiecutter
- Last Pushed: 2026-04-20T14:19:21.000Z (27 days ago)
- Last Synced: 2026-04-20T16:31:02.817Z (27 days ago)
- Topics: boilerplate, cicd, cookiecutter, docker, docker-compose, fastapi, fastapi-boilerplate, fastapi-sqlalchemy, fastapi-template, microservice, orm, python, python3, rest-api, software-engineering, sqlalchemy, template, web-server
- Language: Python
- Homepage:
- Size: 1.28 MB
- Stars: 0
- Watchers: 0
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# FastAPI ORM Template (Cookiecutter)
This is a cookiecutter template for FastAPI with ORM (SQLAlchemy) projects.
## Features
- Cookiecutter
- FastAPI
- REST API
- Web service
- Microservice
- ORM (SQLAlchemy)
- SQL databases (RDB)
- Database migrations (Alembic)
- PostgreSQL
- Project structure
- Boilerplate/Template
- Best practices
- Configuration
- Tests
- Build
- Scripts
- Examples
- Documentation
- CI/CD
- Docker and docker compose
---
## 🐤 Getting started
### 1. 🚧 Prerequisites
- Install **Python (>= v3.10)** and **pip (>= 23)**:
- **[RECOMMENDED] [Miniconda (v3)](https://www.anaconda.com/docs/getting-started/miniconda/install)**
- *[arm64/aarch64] [Miniforge (v3)](https://github.com/conda-forge/miniforge)*
- *[Python virtual environment] [venv](https://docs.python.org/3/library/venv.html)*
For **DEVELOPMENT** environment:
- Install [**git**](https://git-scm.com/downloads)
- Setup an [**SSH key**](https://docs.github.com/en/github/authenticating-to-github/connecting-to-github-with-ssh)
### 2. 📥 Download or clone the repository
```sh
# Create projects directory:
mkdir -pv ~/workspaces/projects
# Enter into projects directory:
cd ~/workspaces/projects
# Clone the repository:
git clone [REPOSITORY_URL]
# Or download and extract the repository from GitHub:
# 1. Go to the repository on GitHub.
# 2. Click on the "Code" button.
# 3. Select "Download ZIP" and save the file to your computer.
# 4. Extract the ZIP file in current directory.
# Enter into the repository:
cd rest-fastapi-orm-template
# Change to cookiecutter branch:
git checkout cookiecutter
```
### 3. 📦 Install cookiecutter
```sh
# Install cookiecutter:
pip install -r ./requirements.txt
# Install pre-commit hooks:
pre-commit install
```
### 4. 🏗️ Generate project with cookiecutter
```sh
# Generate project:
cookiecutter -f .
# Or:
./scripts/build.sh
```
### 5. 🏁 Start the project
```sh
cd [PROJECT_NAME]
# Start:
./compose.sh start -l
# Stop:
./compose.sh stop
```
👍
## 📑 References
- Cookiecutter (GitHub) -
- Cookiecutter (Docs) -