Enferno 🔥

Stop configuring. Start shipping.

Webpack Vite node_modules npm install — Just Python.

git clone git@github.com:level09/enferno.git && cd enferno
./setup.sh                    # Installs deps + generates secure .env
uv run flask create-db        # Setup database
uv run flask install          # Create admin user
uv run flask run              # → http://localhost:5000

Why Enferno?

• Zero build step - Vue 3 + Vuetify 3 run directly in browser. Delete your node_modules
• Auth that works - 2FA, WebAuthn, OAuth (Google/GitHub) — not a tutorial, actual production code
• SQLite by default - Deploy anywhere. Managed database not required
• AI-native - Ships with Claude Code & Cursor rules. Your AI already knows the codebase
• Complexity is opt-in - Redis, Celery, PostgreSQL when you decide, not when the framework demands

Want payments? → ReadyKit adds Stripe, multi-tenancy, teams on top of Enferno

What's Included

• Frontend: Vue 3, Vuetify 3, Axios - no build tools needed
• Auth: Login, registration, 2FA, WebAuthn, OAuth (Google/GitHub)
• Database: SQLAlchemy ORM, migrations ready
• Patterns: Data tables, dialogs, notifications - ready to use

Requirements: Python 3.11+ and uv

Background Tasks

When you need Celery for async jobs:

uv sync --extra full        # Adds Redis + Celery
# Set REDIS_URL, CELERY_BROKER_URL in .env

Docker

Full production stack with one command:

docker compose up --build   # Redis, PostgreSQL, Nginx, Celery

Configuration

Environment variables (.env):

SECRET_KEY=your_secret_key
FLASK_APP=run.py
FLASK_DEBUG=1                    # 0 in production

# PostgreSQL (optional - SQLite works by default)
# SQLALCHEMY_DATABASE_URI=postgresql://user:pass@localhost/dbname

# Background tasks (optional)
# REDIS_URL=redis://localhost:6379/1
# CELERY_BROKER_URL=redis://localhost:6379/2

Documentation: docs.enferno.io

License

MIT