Skip to content

Installation

Requirements

  • Python 3.11+
  • uv (recommended) or pip

Install fastapi-fullstack

Bash
uv tool install fastapi-fullstack
Bash
pip install fastapi-fullstack
Bash
pipx install fastapi-fullstack

Verify Installation

Bash
fastapi-fullstack --version

Create Your First Project

Generate the project, then bring the whole backend up with a single command:

Bash
# 1. Generate your project — just answer the wizard's prompts
fastapi-fullstack

# 2. Backend + PostgreSQL up, migrations applied, default admin seeded
cd my_app
make bootstrap

# 3. Frontend (in a second terminal)
cd frontend && bun install && bun dev

That's it — backend at http://localhost:8000, API docs at /docs, frontend at http://localhost:3000, admin login admin@example.com / admin123.

make bootstrap (= make dev + make seed) builds the backend image, starts the Docker stack, waits for PostgreSQL, applies migrations, and seeds the admin user. It's idempotent — re-run it anytime.

Other ways to generate

Bash
# Non-interactive with explicit options
fastapi-fullstack create my_app --database postgresql --frontend nextjs

# Presets (run `fastapi-fullstack templates` for the full list)
fastapi-fullstack create my_app --preset ai-agent

# Bare-bones project
fastapi-fullstack create my_app --minimal

Available Presets

Preset Description
--preset production Full production setup with Redis, Sentry, Kubernetes, Prometheus
--preset ai-agent AI agent with WebSocket streaming and conversation persistence
--preset production-saas SaaS setup: billing, teams, and admin panel
--minimal Minimal project with no extras

Next Steps