enferno

Name: enferno
Author: level09

Pending

Lean Flask framework built for coding agents: Vue 3 + Vuetify with no build step, production-ready auth (2FA, passkeys, OAuth), AGENTS.md, an agent skill and a read-only MCP server. No webpack, no node_modules, just Python.

568stars

79forks

HTML

Installation

# Add to your Claude Code skills
git clone https://github.com/level09/enferno

Getting Started

Guides for using ai agents skills like enferno.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Compare with similar skills

See how enferno compares with popular alternatives.

enferno vs ecc

See comparison

enferno vs hermes agent

See comparison

README.md

Frequently Asked Questions

What is enferno?

enferno is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by level09. Lean Flask framework built for coding agents: Vue 3 + Vuetify with no build step, production-ready auth (2FA, passkeys, OAuth), AGENTS.md, an agent skill and a read-only MCP server. No webpack, no node_modules, just Python. It has 568 GitHub stars.

Is enferno safe to use?

enferno's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.

How do I install enferno?

Clone the repository with "git clone https://github.com/level09/enferno" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is enferno written in?

enferno is primarily written in HTML. It is open-source under level09 on GitHub, so you can review or fork the full source.

Are there alternatives to enferno?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh enferno against similar tools.

AI Courses · Agentic AI, LLM Engineering & MCP

Beginner to professional · First lesson free · Lifetime access

20% off

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

278,173

Velocity hive

Enferno 🔥

Live Demo · Docs · Tutorials

A Flask framework built for coding agents. You describe the app; your agent builds it on a stack it already understands, and a test suite tells it when it got something wrong.

Plain Python, Vue 3 and Vuetify with no build step, production auth out of the box. No webpack, no node_modules, nothing for the agent to configure.

Start

Paste this into Claude Code, Codex, Cursor or any coding agent:

Clone https://github.com/level09/enferno into ./myapp, follow its AGENTS.md
to set it up, create an admin user, start it on port 5001 and run the tests.

Or by hand:

git clone https://github.com/level09/enferno.git myapp && cd myapp
./setup.sh                    # Installs deps, generates .env with secrets
uv run flask create-db        # Create the database
uv run flask install          # Create an admin user
uv run flask run              # http://localhost:5000

setup.sh never prompts when there is no terminal, so agents and CI run it with flags: --full adds Redis and Celery, --docker configures the Compose stack.

https://github.com/user-attachments/assets/a87bfad2-45dc-4d94-bdf1-0448dfea8084

Then just ask

Add a Product model with name, price and category, an admin page to manage it,
and a migration.

Let users export the activity log as CSV.

Add a status column to users and show it as a chip in the users table.

How your agent knows Enferno

	What it gives the agent	When
`AGENTS.md`	Stack, layout, commands, routes and hard rules, in about 100 lines	Every session, read automatically
`enferno-dev` skill	Full patterns for models, APIs, Vue pages, dialogs, migrations and upgrades	Loaded only when a task needs it
`flask mcp`	Live routes, schema with row counts, migration revision and audit log, read-only	When the agent needs the real state, not the docs
`/llms.txt`	A short description of your app for LLM tools	Edit it to describe what you build

The skill lives in .agents/skills/, the shared location for Codex, Cursor, Copilot and Gemini CLI, and .claude/skills links to it for Claude Code. npx skills add level09/enferno installs it in another project. MCP is opt-in: uv sync --extra dev --extra mcp, and .mcp.json lets MCP-aware agents offer to connect.

How your agent checks its work

Agents write code fast; they also forget migrations and leave routes unprotected. uv run pytest catches the mistakes they actually make:

Every protected route rejects anonymous users, and every admin route rejects non-admins, including routes the agent just added.
Models match migrations: change a model without flask db migrate and the suite fails.
CSRF is enforced on the admin API, and a valid token still works.
Auth flows: login, wrong password, POST-only logout, audited admin CRUD.
setup.sh in every mode, without touching your .env.

Tests run on in-memory SQLite in about four seconds. CI runs them on PostgreSQL across Python 3.11 to 3.14. Set TEST_DATABASE_URI to use PostgreSQL locally; it must be a disposable database, because the suite drops every table.

AGENTS.md also gives the agent the rules that tests cannot: Tabler icons only, POST-only logout, migrations reviewed by hand, and a real browser check after a frontend upgrade.

What's in the box

Frontend: Vue 3, Vuetify 3 and axios, vendored and pinned by vendor.sh. No build step
Auth: login, registration, password recovery, TOTP 2FA, passkeys (WebAuthn), recovery codes, Google and GitHub OAuth
Admin: users, roles and an audit log of admin actions
Database: SQLAlchemy 2 with Alembic migrations. SQLite by default, PostgreSQL when you want it
UI: collapsible sidebar, dark mode, Tabler icons, data tables, dialogs and notifications
Optional: Redis sessions and Celery (--extra full), MCP (--extra mcp), uWSGI (--extra wsgi)

Requires Python 3.11+ and uv.

Deploy

Docker, with PostgreSQL, Redis, Celery and nginx:

./setup.sh --docker
docker compose up --build

Compose requires DB_PASSWORD and REDIS_PASSWORD, which setup.sh --docker generates. For an existing installation, keep the credentials its database and Redis already use. Database and Redis ports stay internal to the Compose network.

Any Ubuntu VPS, with Caddy and automatic SSL, via Ignite:

curl -sSL https://raw.githubusercontent.com/level09/ignite/main/ignite.sh | sudo DOMAIN=your-domain.com bash

Configuration

setup.sh writes .env with generated secrets. The values you are most likely to change:

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

Full guides: docs.enferno.io

ReadyKit adds Stripe, workspaces and teams on top of Enferno.
STK is the same philosophy on Quart (async Flask) with native WebSockets.

License

MIT