erupts/erupt

Erupt – Annotation‑Driven Java Admin Framework with Built‑in AI

What it is – Erupt is an open‑source Java library that turns a JPA entity into a full‑featured admin UI just by adding annotations. It ships as a Spring Boot starter, so you get a runnable admin panel with zero front‑end code, no controllers, and a startup time of only a few seconds.

Why it matters for AI/ML – Beyond the classic CRUD admin UI, Erupt bundles an AI harness (erupt‑ai) and an AI “claw” (erupt‑ai‑claw). These modules let you:

• Connect to 50+ LLM providers (OpenAI, Claude, Gemini, Ollama, etc.) and MCP‑compatible tool servers.
• Expose any Spring bean as an AI tool (@AiToolbox / @Tool) with role‑based access control.
• Use a field‑level writing assistant that can generate, polish, or continue text directly inside forms.
• Interact with the server via natural language (query, create, update data; run shell commands; read/write files; control a browser) through the AI Claw.
• Build multi‑agent workflows (A2A) and keep per‑user chat history, token usage, and long‑term memory—all configurable from the admin UI without restarting the service.

Core capabilities

Feature	What you get
One‑class = one page	Annotate a JPA entity (@Erupt) → auto‑generated tables, forms, search, pagination, tree, Gantt, cards, etc.
Fast startup	2‑5 s on Java 17 + Spring Boot 3.x.
Rich UI components	30+ field types (date picker, slider, map, code editor, markdown, signature, autocomplete …).
RBAC & audit	Built‑in user/role management, row‑level filters, column visibility, OpenAPI generation.
Multi‑DB support	MySQL, PostgreSQL, Oracle, SQL Server, DM; MongoDB via erupt‑mongodb.
Excel import/export, OpenAPI, distributed config (erupt‑cloud).
Commercial extensions	Optional paid modules for workflow, SaaS tenancy, BI cube.

Getting started

1. Clone & run – git clone https://github.com/erupts/erupt && cd erupt && mvn spring-boot:run -pl erupt‑sample -am. The sample uses an in‑memory H2 DB and is reachable at http://localhost:8080 (login / erupt).
2. Docker – Pull the all‑in‑one image erupts/erupt and run docker run -p 8080:8080 erupts/erupt.
3. Maven starter – Add the single dependency xyz.erupt:erupt-spring-boot-starter (or ‑starter‑all for every optional module). Annotate your entity and start the Spring Boot app; the UI appears automatically.
4. No‑code AI skill – Describe a system in plain English to Claude Code (or another LLM) and the AI Skill service will generate the full admin panel (entities, DB, CRUD, permissions) for you.

AI‑specific modules

• erupt‑ai – Production‑grade LLM integration. Choose providers from the UI, define system prompts, expose tools, enforce role‑based tool security, and keep chat history.
• erupt‑ai‑claw – Turn the admin server itself into an AI‑driven assistant: natural‑language data queries, shell commands, file I/O, browser control, and access to a library of 700 k+ pre‑built “skills”.

Ecosystem – Core modules are Apache 2.0 and free forever. Optional commercial modules (Flow, SaaS, Cube) are sold as one‑time purchases with perpetual licenses. The project also offers erupt‑cloud for centralized configuration and topology management across multiple Spring Boot services.

Telemetry & privacy – Anonymous usage stats (version, JDK, OS, DB type, etc.) are sent by default; business data is never transmitted. Telemetry can be disabled via erupt.telemetry.enabled: false or the ERUPT_TELEMETRY_DISABLED=1 env var.

License – Apache 2.0 (free for personal, commercial, and forked use).

---

Bottom line – Erupt lets Java developers spin up a production‑ready admin interface instantly, and its AI modules let you embed LLM‑driven tools, agents, and natural‑language operations directly into that admin UI, all without writing front‑end code.