English  |  中文

ERUPT

MODEL-DRIVEN ENGINE FOR ENTERPRISE APPLICATIONS · AI HARNESS

make the model your single source of truth · built at runtime, not generated · zero front-end · 9 languages · 50+ LLM · MCP · A2A

[ WEBSITE ]   [ LIVE DEMO ]   [ START PROJECT ]   [ AI SKILL ]   [ DOCS ]

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

01 · WHY ERUPT

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

@Erupt(
    name = "Simple",
    power = @Power(importable = true, export = true),
    rowOperation = @RowOperation(
        title = "Custom Action",
        mode = RowOperation.Mode.SINGLE,
        operationHandler = OperationHandlerImpl.class
    )
)
@Table(name = "t_simple")
@Entity
public class Simple extends BaseModel {

    @EruptField(
        views = @View(title = "Text"),
        edit  = @Edit(title = "Text", notNull = true, search = @Search)
    )
    private String input;

    @EruptField(
        views = @View(title = "Date"),
        edit  = @Edit(title = "Date", search = @Search)
    )
    private Date date;

    @EruptField(
        views = @View(title = "Slider"),
        edit  = @Edit(title = "Slider", type = EditType.SLIDER, search = @Search,
            sliderType = @SliderType(max = 90, markPoints = {0, 30, 60, 90}, dots = true))
    )
    private Integer slide;

    @EruptField(
        views = @View(title = "Choice"),
        edit  = @Edit(title = "Choice", type = EditType.CHOICE, search = @Search,
            choiceType = @ChoiceType(
                fetchHandler = SqlChoiceFetchHandler.class,
                fetchHandlerParams = "select id, name from e_upms_menu"
            ))
    )
    private Long choice;
}

List<EruptUser> list = eruptDao.lambdaQuery(EruptUser.class)
        .like(EruptUser::getName, "e")
        .isNull(EruptUser::getWhiteIp)
        .in(EruptUser::getId, 1, 2, 3, 4)
        .ge(EruptUser::getCreateTime, "2023-01-01")
        .list();

03 · OUT OF THE BOX

WHICH AI MODULE? — Pick erupt-ai for raw LLM / MCP access to build your own agent. Pick erupt-ai-claw for a turn-key admin agent (it depends on erupt-ai; add only this one).

All modules — 07 · API reference — javadoc.erupt.xyz

MODEL ATLAS

Every @Erupt entity, every relation between them, drawn from the same annotations that build the UI. No extra configuration — the map exists because the model does.

04 · AI HARNESS

erupt-ai — production-grade AI agents on JVM. 50+ LLM providers · MCP-native · built-in RBAC · role-aware system prompts · chat history. All configurable through the admin UI. Zero boilerplate.

WHY "HARNESS" — Shipping AI to production needs more than an SDK: governance (RBAC) + interoperability (MCP) + observability (chat history, token tracking) + operator-friendly config (admin UI). All four, out of the box.

PROVIDERS — OpenAI · Claude · Gemini · DeepSeek · Qwen · GLM · Doubao · Moonshot · MiniMax · Mistral · Grok · Fireworks · Together · OpenRouter · Ollama (self-hosted) — hot-swappable from the admin UI, 50+ total.

@AiToolbox
@Component
public class MyTools {

    @Tool("Look up order status by order ID")
    public String getOrderStatus(String orderId) {
        return orderService.getStatus(orderId);
    }
}

LLM providers, MCP servers, agents — all managed through the built-in admin UI. No restarts.

FIELD ASSISTANT

Any text field in any generated form gets an inline writing assistant. Nothing to wire up — it appears wherever the schema says the field holds text.

GENERATE · POLISH · CONTINUE · EXPAND · SHORTEN — or just tell it what to write. Streams into the field, and one click undoes it.

05 · AI FAMILY

AI CLAW

erupt-ai-claw — drive your server through natural language, like talking to a colleague.

Claw shares the same role-based tool security as AI Harness — only whitelisted tools reach non-admin users. Skills live in ~/.erupt/skills/ and can also be created through chat.

MORE AGENTS

06 · ANY LANGUAGE · CLOUD

erupt-cloud — one model-driven admin for distributed services in any language. One server handles login, menus and permissions; each node — Spring Boot or a Python / Go / TypeScript / PHP / .NET / Rust / Ruby / Swift process — only describes its models and serves their data.

┌────────────────────────────┐
│  erupt-cloud-server        │   console · login · menus · RBAC
│  config · nodes · topology │
└──────────────┬─────────────┘
               │  register / heartbeat / forward
   ┌───────────┼───────────┬───────────┐
   ▼           ▼           ▼           ▼
┌───────┐  ┌────────┐  ┌───────┐  ┌───────┐
│ Java  │  │ Python │  │  Go   │  │ TS …  │   nodes in any of 9 languages
│ node  │  │  node  │  │ node  │  │ node  │   each owns its models + data
└───────┘  └────────┘  └───────┘  └───────┘

# pip install erupt-sdk  — a Python service becomes an erupt admin node
from erupt import Field, Node, SqliteRepository, erupt

@erupt("Article")
class Article:
    id: int = Field(pk=True)
    title: str = Field("Title", search=True, not_null=True)

node = Node("blog", os.environ["ERUPT_ACCESS_TOKEN"], "http://erupt-server:8080")
node.register(Article, SqliteRepository("blog.db", "article"))
node.serve(port=9090)

docs.erupt.xyz/modules/erupt-cloud · erupt.xyz/#!/cloud · erupt.xyz/#!/sdk

07 · MODULES

One core, fifty-odd modules. Each is one dependency and shares the same model, permissions and UI.

Full list — erupt.xyz · API reference — javadoc.erupt.xyz

08 · COMMERCIAL MODULES

CORE IS FREE, FOREVER — erupt-core / erupt-annotation / erupt-web / erupt-jpa / erupt-upms / erupt-ai and other core modules are Apache 2.0 forever. No license restrictions · no project-count limits · no commercial restrictions (governance commitment →). Commercial modules are optional enterprise extensions that evolve independently.

Source-code delivery · one-time purchase · perpetual use.

PRICING & PURCHASE →

09 · TELEMETRY

Erupt reports anonymous usage statistics — erupt version, installed modules, JDK, OS and database type, Spring Boot version, timezone — to guide compatibility and roadmap decisions. It never sends business data, credentials, hostnames, or anything IP-derived, and requests fail silently without ever blocking startup.

Opt out with erupt.telemetry.enabled: false or the ERUPT_TELEMETRY_DISABLED=1 environment variable; CI is skipped automatically.

10 · CONTRIBUTING

Free and open source. Code, bug reports, ideas, use cases, blog posts — all welcome.

Read the contribution guidelines, then open an issue or pull request.

IF ERUPT SAVES YOU TIME — STAR IT. It really helps the project grow.

11 · LICENSE

Apache 2.0 — free · open source · commercial use permitted · fork-friendly.

AUTHOR — YuePeng · erupts@126.com