Erupt

English  |  中文

---

---

---

00 · THE IDEA

Make the model your single source of truth. Describe a business object once — its fields, types, relations and rules — and Erupt builds the rest of the system from it at runtime. Nothing is generated, so nothing drifts: change the model, and the UI, APIs, permissions and data layer change with it, instantly.

              ┌──────────────────────────────────────────┐
              │ Task                              model  │
              │ title  · text      priority · choice     │
              │ due    · date      owner    · → User     │
              └─────────────────────┬────────────────────┘
                                    │   read at runtime — nothing is generated
      ┌───────────┬───────────┬─────┴─────┬───────────┬───────────┐
      ▼           ▼           ▼           ▼           ▼           ▼
   Admin UI    REST API      RBAC        Data       Audit      AI Agent
   9 views     OpenAPI    row · col   15 sources   revision      MCP

WHAT THE MODEL BUILDS	WHAT YOU NO LONGER WRITE
TABLE · FORM — 30+ field components	html · js · css
SEARCH · SORT · PAGE	query code
REST · OPENAPI — permission-aware	Controller
DATAPROXY — lifecycle hooks	Service
AUTO DDL	DDL · Mapper
RBAC — menu · row · column · button	permission code
ROW ACTIONS — with forms and confirm	action endpoints
EXCEL I/O	POI glue
9 VIEWS — table · gantt · board · calendar · timeline · map · card …	custom pages
REVISION — field-level history, rollback	history tables
I18N	*.properties
AI TOOLS · MCP — every model is agent-operable	tool glue

---

01 · WHY ERUPT

RUNTIME, NOT CODEGEN	The model is read at runtime. No generated code to maintain, no template drift — edit the model and the system follows.
FAST	2–5 seconds to a running system. Java 17 + Spring Boot 3.x.
BATTERIES INCLUDED	Login, users, roles, menus, audit, Excel, OpenAPI, 30+ components — production-ready on day one.
AI-NATIVE	50+ LLM providers, MCP-native tools, A2A, 700k+ skills. Every model is something an agent can query and operate.
ANY DATA SOURCE	JPA (MySQL · PostgreSQL · Oracle · SQL Server · DM) · JDBC · MongoDB · Elasticsearch · Redis · S3 · HTTP · files · LDAP · Kubernetes · Feishu · DingTalk · Notion · Airtable.
ANY FRAMEWORK	Not tied to Spring: the same model runs on Spring Boot, Solon, Quarkus, Micronaut, Vert.x, Ktor or any servlet container.
ANY LANGUAGE	Python, Go, TypeScript, PHP, .NET, Rust, Ruby and Swift services join as erupt-sdk nodes — same admin, same permissions.
FREE CORE	Apache 2.0, forever. Commercial Flow / SaaS / Cube modules are optional.

---

02 · QUICKSTART

A — SOURCE

Clone and run the bundled sample. H2 in-memory. No config.

git clone https://github.com/erupts/erupt.git
cd erupt
mvn spring-boot:run -pl erupt-sample -am
# → http://localhost:8080   login: erupt / erupt

B — DOCKER

All-in-one image — hub.docker.com/r/erupts/erupt. Built on erupt-spring-boot-starter-all: designer, job, monitor, magic-api, notice, AI, cloud-server, embedded H2. Zero configuration.

docker run -p 8080:8080 erupts/erupt
# → http://localhost:8080   login: erupt / erupt

Production: switch to MySQL / Redis via -e env vars — image guide →

C — MAVEN

1 · One dependency.

<dependency>
    <groupId>xyz.erupt</groupId>
    <artifactId>erupt-spring-boot-starter</artifactId>
    <version>${erupt.version}</version>
</dependency>

Bundles everything a runnable admin needs (erupt-admin + erupt-web). Want every optional module too (designer, job, generator, monitor, magic-api, websocket, notice, print, terminal, AI, cloud-server)? Use erupt-spring-boot-starter-all.

2 · Describe the model. This IS the system.

@Erupt(name = "User")
@Entity
public class User extends BaseModel {

    @EruptField(
        views = @View(title = "Name"),
        edit  = @Edit(title = "Name", search = @Search)
    )
    private String name;
}

3 · Run.

mvn spring-boot:run
# → http://localhost:8080   login: erupt / erupt

Paged. Searchable. Exportable. Role-gated. Add a field, refresh, it shows up.

D — STARTER

start.erupt.xyz — pick modules in your browser, download a ready-to-run project. No local setup.

E — AI SKILL

skill.erupt.xyz — build a full admin panel with zero development background. Made for non-engineering roles (ops, HR, product, finance): describe your system in one sentence inside Claude Code or a similar AI agent, and the skill handles the rest — JDK, database (H2), login, CRUD, search, Excel, permissions all included. Only entities get written; UI and APIs render from annotations at runtime, so it costs ~1/20 the tokens of writing from scratch.

git clone https://github.com/plinian/erupt-skill.git ~/.claude/skills/erupt-admin

Then tell Claude Code: "Build me a CRM admin panel" → running system.

NO INSTALL — demo.erupt.xyz (guest / guest) FULL GUIDE — docs.erupt.xyz/guide/quick-start

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗