AI-Optimized Framework

Ship production apps at warp speed.

Enferno is a modern Flask framework built for AI-assisted development. Combine intelligent patterns, Vue 3, and battle-tested security to launch your SaaS faster than ever.

5 min
Setup to running
MIT
Open source
10+
Years battle-tested
Terminal
$ git clone git@github.com:level09/enferno.git
$ cd enferno && ./setup.sh
Creating virtual environment...
Installing dependencies...
✓ Environment ready
$ uv run flask run
✓ Running on http://localhost:5000
Features

Everything you need to ship fast.

From authentication to background tasks, Enferno handles the infrastructure so you can focus on building your product.

🔐

Complete Auth System

Flask-Security with 2FA, WebAuthn, OAuth (Google & GitHub), and role-based access control.

  • Two-factor authentication
  • Social login ready
  • Session protection
🎨

Vue 3 + Vuetify

Modern frontend with no build step required. Material Design components work directly in the browser.

  • No webpack needed
  • 50+ UI components
  • Custom delimiters for Jinja

AI-Optimized Patterns

Smart Cursor Rules and contextual guides help AI assistants understand your codebase.

  • Cursor-ready rules
  • Consistent patterns
  • Self-documenting code
⏱️

Background Tasks

Celery integration with Redis for reliable async processing. Handle emails, jobs, and scheduled tasks.

  • Celery workers ready
  • Redis broker included
  • Scheduled task support
📦

Modern Python Stack

Python 3.11+, SQLAlchemy 2.x, Celery for background tasks, and uv for fast package management.

  • SQLAlchemy 2.x patterns
  • Redis sessions
  • Type-safe queries
🐳

Docker Production

One-command deployment with Docker Compose. Includes PostgreSQL, Redis, Nginx, and Celery workers.

  • Production-grade config
  • Auto SSL ready
  • Zero-downtime deploys
Quick Start

From clone to running in minutes.

No complex configuration. Just clone, setup, and start building.

1

Clone & Setup

One script configures everything including virtual environment and secure keys.

bash
git clone git@github.com:level09/enferno.git
cd enferno
./setup.sh
2

Initialize Database

Create tables and admin user with a single command.

bash
uv run flask create-db
uv run flask install
3

Run & Build

Start developing locally or deploy with Docker.

bash
# Development
uv run flask run

# Production
docker compose up --build
Developer Experience

Clean patterns, zero boilerplate.

Enferno uses modern Flask patterns that are easy to understand and extend.

Blueprint Structure

python
# enferno/portal/views.py
from flask import Blueprint, render_template
from flask_security import auth_required

portal = Blueprint('portal', __name__)

@portal.route('/dashboard')
@auth_required()
def dashboard():
    return render_template('portal/dashboard.html')

Vue 3 Integration

javascript
// Uses ${} delimiters to avoid Jinja conflicts
const app = Vue.createApp({
  delimiters: ['${', '}'],
  data() {
    return { items: [] }
  },
  methods: {
    async loadItems() {
      const res = await axios.get('/api/items')
      this.items = res.data
    }
  }
})

Factory pattern, blueprint organization, and SQLAlchemy 2.x throughout.

Tech Stack

Battle-tested, production-ready.

Every component chosen for reliability and developer experience.

🐍 Python 3.11+
🔥 Flask 3
🟢 Vue 3
🎨 Vuetify 3
🗄️ SQLAlchemy 2.x
🐘 PostgreSQL
💠 Redis
📋 Celery
🐳 Docker
📦 uv
🔐 Flask-Security
🌐 Nginx
Open Source

Free forever.

$ 0 / MIT License
  • Full source code access
  • Commercial use allowed
  • Modify and redistribute
  • No attribution required
  • Community support
  • Regular updates
Clone from GitHub

Build your SaaS without limits.

FAQ

Common questions.

Not necessarily. Enferno works great with vanilla JavaScript too. Vue 3 + Vuetify are included for those who want a rich component library, but you can use any frontend approach.

Absolutely. MIT license gives you complete freedom to build and sell commercial applications without any restrictions or attribution requirements.

Enferno includes smart Cursor Rules, consistent patterns, and contextual guides that help AI assistants like Claude and GPT understand your codebase structure. This makes pair-programming with AI significantly more effective.

Enferno provides production-ready defaults: authentication with OAuth, background tasks with Celery, Docker deployment, and a modern Vue 3 frontend. It's the boilerplate you'd build anyway, already battle-tested.