gigaplate 0.1.0

Python project template generator

Gigaplate

Python project template generator with modular architecture.

Installation

pip install gigaplate
# or
pipx install gigaplate
# or
uv tool install gigaplate

Usage

# Base project only
gigaplate my_project

# With FastAPI
gigaplate my_project --fastapi

# FastAPI + SQLAlchemy + Redis
gigaplate my_project --fastapi --sqlalchemy --redis

# Aiogram bot with database
gigaplate my_project --aiogram --sqlalchemy --redis

# Using short flags
gigaplate my_project -f -s -r

# Using comma-separated list
gigaplate my_project -- fastapi,sqlalchemy,redis

Available Modules

Module	Flag	Description
FastAPI	--fastapi, -f	REST API with FastAPI
SQLAlchemy	--sqlalchemy, -s	Async SQLAlchemy + Alembic
Redis	--redis, -r	Redis connection
Aiogram	--aiogram, -a	Telegram bot with aiogram
CLI	--cli, -c	Click CLI interface

Module Interactions

• FastAPI + SQLAlchemy: Adds session dependency injection
• Aiogram + SQLAlchemy: Adds session/user middlewares, user model
• SQLAlchemy + Redis: Reorganizes db folder (db/sql/, db/redis/)
• FastAPI + Aiogram: Not allowed (mutually exclusive)

Generated Project Structure

my_project/
├── my_project/
│   ├── __init__.py
│   ├── config.py
│   ├── main.py / app.py
│   ├── controllers/
│   ├── middlewares/
│   ├── db/
│   └── utils/
├── config/
├── migrations/          # if sqlalchemy
├── Taskfile.yaml
├── docker-compose.yaml
├── pyproject.toml
└── CLAUDE.md

License

MIT