Skip to main content

Fastman

The elegant CLI for FastAPI artisans.

Fastman is a Laravel-inspired command-line tool that brings structure, speed, and best practices to FastAPI development. Instead of manually wiring up project scaffolding, database configurations, migrations, and authentication — Fastman handles it all from the terminal so you can focus on building your application logic.

30 seconds to your first API​

# 1. Install
pip install fastman

# 2. Create a project with PostgreSQL
fastman create my-api --database=postgresql

# 3. Navigate into the project and scaffold a feature
cd my-api
fastman make:feature users --crud

# 4. Create a migration, apply it, and start the server
fastman make:migration "create users table"
fastman database:migrate
fastman serve

Open http://localhost:8000/docs — you now have a fully documented REST API with CRUD endpoints, Swagger UI, database migrations, and a clean project structure.

Why Fastman?​

FastAPI gives you incredible performance and flexibility — but every new project means repeating the same setup: choosing an architecture, configuring a database connection, setting up Alembic for migrations, adding authentication, and writing boilerplate for every new feature.

Fastman eliminates that repetitive work. With a single command you get opinionated defaults that follow production-tested best practices, while every generated file remains fully customizable. There's no lock-in — it's your code from the start.

What you get​

CommandWhat it does
fastman createProduction-ready project with configuration, database, migrations, and tests
make:featureComplete vertical slice — model, schema, service, and router — in one command
make:model, make:service, ...15+ generators for every component type (controllers, middleware, repos, etc.)
database:migrateAlembic migrations without touching INI files or configuration
install:auth --type=jwtFull JWT auth with /register, /login, /me endpoints and password hashing
install:certBuild a merged CA bundle from project-local .pem / .crt files for private services
serveDevelopment server with automatic hot reload
tinkerInteractive Python shell with your database session pre-loaded
route:listView all registered API routes in a formatted table

Supported databases​

SQLite · PostgreSQL · MySQL · Oracle · Firebase

Supported package managers​

uv · poetry · pipenv · pip — auto-detected from your project

Architecture patterns​

  • Feature — vertical slices, each feature is self-contained (recommended)
  • API — resource-grouped with built-in API versioning
  • Layer — traditional MVC-style separation of concerns

What's New in v0.3.6 (Cheetah)​

  • Keycloak switched to fastapi-keycloak with dependency-based route protection
  • GET /me endpoint automatically registered for Keycloak auth
  • Swagger Authorize button via idp.add_swagger_config(app)
  • Lazy Keycloak initialization — no network calls at import time, no SSL crashes on startup
  • Non-destructive SSL support — Fastman builds a merged CA bundle instead of modifying certifi
  • Graceful startup fallback — the app still boots if Keycloak is unreachable or admin token setup is incomplete

See the full changelog.

📖 Getting Started

New to Fastman? Start here — install the CLI and create your first project in under 5 minutes.

Installation →

🎯 Commands Reference

Browse all 30+ commands with options, flags, and real-world examples.

View Commands →