Skip to content

Tech Stack

This document provides a comprehensive overview of the technologies, tools, and infrastructure powering the FastAPI Enterprise Backend Template.

๐Ÿ—๏ธ Core Architecture

  • ๐Ÿ Python 3.12+ โ€” High-performance interpreter with advanced language features.
  • โšก FastAPI โ€” High-performance, production-ready web framework for building APIs.
  • ๐Ÿ“ Pydantic v2 โ€” Modern data validation and settings management using type hints.
  • ๐Ÿ”ข FastAPI-Pagination โ€” Uniform pagination support for clean and consistent list responses.

๐Ÿ—„๏ธ Persistence & Data

  • ๐Ÿ˜ PostgreSQL 18 โ€” The world's most advanced open-source relational database.
  • ๐Ÿงฌ SQLModel โ€” Elegant unification of SQLAlchemy and Pydantic for data modeling.
  • ๐Ÿ› ๏ธ Alembic โ€” Robust database migration management for versioned schema updates.
  • ๐Ÿ”Œ psycopg3 โ€” Modern, high-performance PostgreSQL adapter for Python.

๐Ÿ›ก๏ธ Security & Health

  • ๐Ÿ”‘ OAuth2 + JWT โ€” Industry-standard secure authentication and authorization.
  • ๐Ÿ”’ Argon2 โ€” State-of-the-art password hashing for maximum credential security.
  • ๐Ÿšฆ SlowAPI โ€” Advanced rate limiting to protect endpoints from automated abuse.
  • ๐Ÿ›ก๏ธ Bandit โ€” Automated security linting to identify and mitigate vulnerabilities.

๐Ÿ“Š Observability & Resilience

  • ๐Ÿชต Structlog โ€” High-performance structured logging for deep system visibility.
  • ๐Ÿ“ˆ Prometheus โ€” Real-time metrics instrumentation for monitoring system health.
  • ๐ŸŽฏ Sentry SDK โ€” Proactive error tracking and performance monitoring with native FastAPI integration.
  • โœจ Rich โ€” Beautiful console formatting and traceback visualization for local development.
  • ๐Ÿ”„ Tenacity โ€” Sophisticated retry logic for handling transient operational failures.

๐Ÿ“ง Email & Templating

  • โœ‰๏ธ Emails โ€” Simplifies sending emails with custom headers and attachments.
  • ๐ŸŽจ Jinja2 โ€” Modern and designer-friendly templating engine for Python.
  • ๐Ÿ” Email-Validator โ€” Robust validation for email addresses to ensure data integrity.

๐Ÿ› ๏ธ Tooling & Infrastructure

  • ๐Ÿ“ฆ uv โ€” Next-generation, lightning-fast Python package and project manager.
  • ๐Ÿณ Docker & Compose โ€” Full-stack container orchestration for environmental parity.
  • ๐Ÿงญ Traefik โ€” Local reverse proxy for stable .test service URLs.
  • ๐Ÿ“ฅ MailCatcher โ€” Instant SMTP server for capturing and inspecting emails during development.
  • ๐Ÿฆ€ Zensical โ€” Ultra-fast, Rust-powered documentation generator for this project.
  • ๐Ÿค– Google Antigravity โ€” AI coding collaborator for implementation, review, documentation, and repository maintenance.
  • ๐Ÿค– Gemini CLI โ€” AI-powered autonomous agent for rapid, surgical engineering.

๐Ÿงช Quality Assurance

  • ๐Ÿงช Pytest & Coverage โ€” Mature testing framework with detailed coverage reporting.
  • ๐Ÿณ Testcontainers โ€” Isolated, containerized integration testing.
  • ๐Ÿง  Hypothesis โ€” Advanced property-based testing for edge-case identification.
  • ๐Ÿš€ py-spy & Scalene โ€” Advanced performance profiling for CPU and memory optimization.
  • ๐Ÿงน Ruff โ€” Extremely fast, all-in-one Python linter and code formatter.
  • ๐Ÿ” Mypy โ€” Strict static type checking to eliminate runtime type errors.
  • โš“ Prek โ€” Ultra-fast, Rust-powered Git hook manager for automated code quality checks.