Vibetuner¶

Production-ready FastAPI Web Application Scaffolding in Seconds¶

Vibetuner generates full-stack web applications with authentication, database, frontend, Docker deployment, and CLI tools pre-configured. Built by All Tuner Labs for rapid iteration and modern development.

What You Get¶

uvx vibetuner scaffold new my-project
cd my-project && just dev
# → Full application running at http://localhost:8000

In 30 Seconds You Have¶

✅ FastAPI backend with async support
✅ Flexible database: MongoDB (Beanie) or SQL (SQLModel/SQLAlchemy)
✅ OAuth + magic link authentication
✅ HTMX reactive frontend
✅ Tailwind CSS + DaisyUI styling
✅ Docker dev/prod environments
✅ Background jobs with Redis (optional)
✅ i18n support
✅ Hot reload for everything

Core Principles¶

Born from real needs at All Tuner Labs when spawning new projects:

Simplicity: Minimal boilerplate, clear conventions, obvious patterns
Speed: Sub-second hot reload, one command to start, fast iteration
Modern Stack: Latest stable versions, async-first, production-tested
Assistant-Friendly: Works great with Claude, Cursor, and other coding AI

Quick Links¶

Quick Start - Get started in 5 minutes
Development Guide - Daily development workflow
Tech Stack - Technologies and why we chose them
CLI Reference - Command-line usage for vibetuner
Scaffolding Reference - Template prompts and update workflow
Contributing - Help improve Vibetuner

Tech Stack¶

Backend¶

FastAPI - Modern async web framework
Granian - High-performance ASGI server

Database (choose your stack)¶

MongoDB + Beanie ODM - Document database (optional)
SQLModel / SQLAlchemy - SQL databases: PostgreSQL, MySQL, MariaDB, SQLite (optional)
Redis + Streaq - Caching and background jobs (optional)

Frontend¶

HTMX - Dynamic HTML without complex JavaScript
Tailwind CSS - Utility-first CSS framework
DaisyUI - Beautiful Tailwind components
Jinja2 - Template engine with i18n

DevOps¶

Docker - Multi-stage builds for dev/prod
uv - Fast Python package management
bun - Fast JavaScript tooling
just - Command runner

Project Structure¶

Generated projects separate framework code from your code:

my-app/
├── src/vibetuner/          # Core framework (immutable)
│   ├── frontend/           # FastAPI app, auth, middleware
│   ├── models/             # User, OAuth models
│   └── services/           # Email, storage services
├── src/app/                # Your code (edit freely)
│   ├── frontend/routes/    # Your HTTP routes
│   ├── models/             # Your database models
│   └── services/           # Your business logic
├── templates/              # Jinja2 templates
└── Dockerfile              # Production deployment

Community¶

GitHub: alltuner/vibetuner
Issues: Report bugs or request features
PyPI: vibetuner
npm: @alltuner/vibetuner