Forge Logo

PyPI version Python Versions Downloads License: MIT

Forge is a powerful command-line tool that helps you quickly bootstrap production-ready FastAPI projects with best practices, intelligent defaults, and a beautiful interactive interface.

✨ Key Features

  • 🎨 Beautiful Interactive UI - Stunning terminal interface with gradient colors and smooth animations

  • 🚀 Smart Presets - Carefully curated presets for testing, dev tools, deployment, and monitoring

  • 🔐 Authentication Ready - Built-in support for JWT authentication (Basic & Complete)

  • 🗄️ Database Flexibility - Support for PostgreSQL, MySQL, and SQLite with SQLModel/SQLAlchemy

  • 🔴 Redis Integration - Built-in Redis support for caching, sessions, and message queues

  • 📋 Background Tasks - Celery integration with Redis broker for async task processing

  • 💾 Database Backup - Automated database backup tasks supporting all database types

  • 📦 Modular Architecture - Choose only the features you need

  • 🧪 Testing Built-in - Pre-configured pytest with async support and coverage

  • 🐳 Docker Ready - Production-ready Docker and Docker Compose configurations

  • 🔍 Type Safe - Full type hints throughout generated code

  • ⚡ Async First - Optimized for FastAPI’s async capabilities

Quick Start

Get started with Forge in just a few commands:

# Install from PyPI
pip install ningfastforge

# Create your first project (interactive mode)
forge init

# Navigate to project and run
cd my-project
uv sync
uv run uvicorn app.main:app --reload

Visit http://127.0.0.1:8000/docs to see your API documentation!

What You Get

When you create a project with Forge, you get:

  • ✅ Fully structured FastAPI application

  • ✅ Database models and migrations (Alembic)

  • ✅ JWT authentication with user management

  • ✅ CRUD operations and API routers

  • ✅ Redis caching and session management

  • ✅ Celery background tasks and scheduling

  • ✅ Docker and Docker Compose configuration

  • ✅ Comprehensive test suite with pytest

  • ✅ Development tools (Black, Ruff)

  • ✅ Environment configuration files

  • ✅ Complete documentation and examples

Table of Contents

Getting Started

User Guide

Architecture

API Reference

Developer Guide

Additional Information

Community and Support

License

Forge is released under the MIT License.

Made with ❤️ for the FastAPI community