fastapi-kris 1.0.0

The Create Next App equivalent for FastAPI — scaffold production-ready FastAPI projects in seconds.

fastapi-kris

The Create Next App equivalent for FastAPI — scaffold production-ready projects in seconds.

---

Features

• 🚀 Beautiful interactive CLI — keyboard navigation, colors, progress bars
• 🏗️ Three architectures — Basic, Layered, Microservice
• 🗄️ Database support — PostgreSQL, MySQL, SQLite, None
• 🔐 Authentication — JWT, OAuth2, None
• 🐳 Docker ready — Dockerfile, docker-compose, .dockerignore
• 🧪 Test suite — Pytest with async support
• 📄 Environment files — .env + .env.example pre-populated
• ⚡ Zero config — the generated project runs immediately

---

Installation

pip install fastapi-kris

---

Usage

Interactive mode

fapi new my-first-api

Skip all prompts (use defaults)

fapi new my-first-api --yes
fapi new my-first-api -y

Default configuration:

Setting	Default
Architecture	Microservice
Database	PostgreSQL
ORM	SQLAlchemy
Authentication	JWT
Docker	Yes
Testing	Pytest
Env file	Yes

Other commands

fapi --help          # Show help
fapi new --help      # Show help for `new` command
fapi version         # Show CLI version

---

Architectures

Basic

Simple, single-layer structure. Ideal for small APIs and beginners.

my-api/
├── main.py
├── config.py
├── routers/
│   ├── health.py
│   └── sample.py
├── core/          # (if auth selected)
├── tests/
├── requirements.txt
├── .env
└── README.md

Layered

Clean separation of concerns following the Repository / Service / Router pattern.

my-api/
├── main.py
├── config.py
├── app/
│   ├── routers/
│   ├── services/
│   ├── repositories/
│   ├── models/
│   ├── schemas/
│   ├── database/
│   ├── dependencies/
│   ├── utils/
│   ├── core/
│   └── exceptions/
├── tests/
├── requirements.txt
├── .env
└── README.md

Microservice

Production-grade microservice architecture with an API Gateway, three services, shared utilities, and Docker Compose wiring.

my-api/
├── gateway/
├── services/
│   ├── auth-service/
│   ├── user-service/
│   └── product-service/
├── shared/
├── docker-compose.yml
├── .env
└── README.md

---

Example Session

🚀 FastAPI-Kris

Project:
my-first-api

Project Description:
> My first FastAPI application

Project Architecture
❯ Basic
  Layered
  Microservice

Database
❯ PostgreSQL
  MySQL
  SQLite
  None

...

Generating project...

████████████████████

✔ Project my-first-api generated successfully!

---

Getting Started After Generation

cd my-first-api
pip install -r requirements.txt
cp .env.example .env   # update values
uvicorn main:app --reload

Open: http://localhost:8000/docs

---

Contributing

See DEVELOPER_GUIDE.md for setup instructions.

---

License

MIT