fastapi-init-cli 🚀

An interactive, production-ready CLI tool to scaffold modern FastAPI backends in seconds.

✨ Features

• Async-First & Sync Support: Async SQLAlchemy 2.0 (asyncpg, aiomysql, aiosqlite) or standard Sync.
• Multiple Databases: PostgreSQL, MySQL, and SQLite.
• Modular Authentication:
  • JWT (Access & Refresh tokens with Bearer auth)
  • Google OAuth 2.0 integration
  • OTP-based Email Verification
  • OTP-based Forgot & Reset Password flow
  • Secure bcrypt password hashing
• Clean Architecture:
  • app/core/ (Pydantic v2 settings, database session dependency, security)
  • app/models/ (SQLAlchemy 2.0 models)
  • app/schemas/ (Pydantic v2 request/response schemas)
  • app/services/ (Clean business logic layer)
  • app/routes/ (Versioned FastAPI routers)
• Database Migrations: Automatic async/sync Alembic migration setup.
• Zero Runtime Lock-in: The scaffolded project is 100% standard FastAPI with no dependency on fastapi-init-cli.

📦 Installation

pip install fastapi-init-cli

🚀 Quickstart

Run the interactive CLI:

fastapi-init

(or fastapi-init-cli)

Interactive Walkthrough:

╭─────────────────────────────────────────────────────────────╮
│                        FastAPI Init                         │
│       Create a production-ready FastAPI backend in seconds.  │
╰─────────────────────────────────────────────────────────────╯

? Project / Folder name: backend
? Select database engine: PostgreSQL
? Select execution architecture: Async
? Do you want authentication? Yes
? Select authentication method: JWT + Google OAuth
? Do you want email verification? (OTP-based) Yes
? Do you want forgot-password functionality? (OTP-based) Yes
? Do you want database migrations with Alembic? Yes

Then start your new backend:

cd backend
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload

🛠️ Development & Contributing

1. Clone the repository:

   git clone https://github.com/your-username/fastapi-init.git
   cd fastapi-init
   

2. Install in editable mode with development dependencies:

   pip install -e ".[dev]"
   

3. Run tests:

   pytest
   

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.