pratham-backend 0.2.1

Scaffold a FastAPI + SQLAlchemy backend boilerplate in seconds

pratham-backend

A CLI that generates a ready-to-code FastAPI + SQLAlchemy + SQLite backend project — folders, DB session wiring, an example CRUD resource, and tests — so you can skip straight to writing business logic instead of rebuilding the same plumbing every time.

Install & use

# one-off, no permanent install (like npx)
uvx pratham-backend init "My API"

# or install it properly
pip install pratham-backend
pratham-backend init "My API"

This creates a my_api/ folder with a working FastAPI app.

Optional: authentication

Add --auth to generate a full JWT + Google OAuth auth module alongside the base project:

pratham-backend init "My API" --auth

This adds:

• Repository pattern (app/repositories/) — generic BaseRepository + UserRepository
• Service layer (app/services/auth_service.py) — registration, login, JWT issuance, Google token exchange
• Validation — Pydantic schemas with real constraints (email format, password length)
• Centralized error handling (app/core/exceptions.py) — every error returns the same {"error_code", "detail"} shape
• Routes: POST /auth/register, POST /auth/login, GET /auth/me (protected), GET /auth/google/login, GET /auth/google/callback

Without --auth, none of this is included — the base project stays auth-free.

Local development

cd pratham-backend
pip install -e . --break-system-packages   # editable install
pratham-backend init "Demo Project"
pratham-backend init "Demo Project Auth" --auth