FastAPI Starter ⚡

A structured FastAPI template with modular design for hackathons, prototypes, and learning purposes.
Includes Items modules with controllers, models, services, and database ( Postgrase ) integration.

---

🚀 Features

• FastAPI server with modular architecture
• Items management (CRUD operations)
• Controllers → handle requests
• Services → business logic
• Models → Pydantic schemas
• Ready for Dockerization use
• Postgrase Database ready for use with samples
• Automatic API docs via Swagger (/docs) and ReDoc (/redoc)

---

⚡ Getting Started

Prerequisites

• Python 3.11+
• pip
• venv ( virtual environment for python )

Create Virual Envirnoment

python -m venv env
# Windows
source env/Scripts/activate
# Linux/Unix
source env/bin/activate

Install dependencies

-# No need for this for the app to run with docker

pip install -r requirements.txt

Run App

# development
uvicorn main:app --reload

# production
uvicorn main:app --host 0.0.0.0 --port 8000

Run the app in a docker container

docker compose up --build