Scallpy (beta): Scaffold FastAPI Projects Like Vite – In Seconds

Source: Dev.to

🤯 The Productivity Dilemma: Slow or Heavy?

FastAPI is incredibly fast, but its scaffolding ecosystem isn’t always.

If you’re like most, you’ve experienced one of these two painful paths when starting a project:

• Manual Route (The slow path) 🐌 – Setting up folder structure, testing, initial DB connection, Pydantic, and environment variables consumes hours you should dedicate to business logic.
• Template Route (Bloat) 🐘 – Using heavy templates imposes unnecessary complexity and features you won’t use, leading to bloated code that you end up removing.

The real problem: we need the startup speed of a modern CLI framework, but with the freedom and minimalism of FastAPI.

💡 The Difference: Interactive, Not Imposing

Here’s the game‑changer. Instead of boilerplate that gives you everything, we built Scallpy – a CLI tool that gives you only what you ask for. It’s interactive, flexible, and keeps things minimal.

🛠 What’s Inside? Control Is in Your Hands

The result is a clean structure that respects Python community standards, with a focus on readability.

Clean Project

myproject/
├── src/
│   └── myproject/
│       ├── __init__.py
│       └── main.py
├── tests/
│   └── test_basic.py
├── .gitignore
├── pyproject.toml
└── README.md

Structured Project

myproject/
├── src/
│   └── myproject/
│       ├── __init__.py
│       ├── api/
│       │   ├── __init__.py
│       │   └── routes.py
│       ├── core/
│       │   ├── __init__.py
│       │   └── config.py
│       ├── main.py
│       └── models/
│           └── __init__.py
├── tests/
│   └── test_basic.py
├── .env
├── .gitignore
├── pyproject.toml
├── README.md
└── requirements.txt

Add --use-db for database support or --use-orm for ORM models. This scales better for larger apps.

🧠 Smart Design: The Commented DB

Why is the database code commented out? To keep things flexible. Not every project needs a DB from day one, so the imports and startup event are commented. Uncomment them when you’re ready to add database support—it’s that simple. This avoids forcing unnecessary dependencies while keeping the template clean and minimal.

⚠️ Beta Status

Scallpy is currently in beta. The tool isn’t fully mature yet, so you might encounter minor bugs or unexpected behavior. If you find any issues, please report them on GitHub—we’ll fix them quickly. Your feedback helps us improve and reach a stable release!

🤝 Try It and Contribute

Ready to give Scallpy a try? Install it with:

pip install scallpy

and create your first project in seconds:

scallpy create

Give it a star on GitHub if you like it. Contribute by reporting issues, suggesting features, or submitting pull requests.