Add Erupt to the list of resources

[erupts]

No description provided.

[jamesward]

/review

[github-actions]

Contribution Review

Summary: Adds "Erupt" — an annotation-driven Java admin framework with an AI module — to the AI Frameworks section of SPEC.md.

Erupt

• Java/JVM Specific: Yes. Erupt is a Java framework built on Spring Boot 3 with JPA, and the erupt-ai module uses LangChain4j. The codebase is 95.7% Java.

• Relevance (>10% of Java AI devs): Uncertain / Borderline. Erupt has ~2.7k GitHub stars, but it is primarily a low-code admin/CRUD framework — not an AI framework. The AI capabilities are a secondary module (erupt-ai) added on top. Its community appears to be predominantly Chinese-speaking (documentation is in Chinese, most issues and discussions are in Chinese). It is unclear whether >10% of Java AI developers in the broader global community would use or encounter this project. It may be more relevant to the Chinese Java ecosystem specifically.

• Link Verification:

  • GitHub — ✅ Reachable, matches description. Active Java repository with 2.7k stars, Apache-2.0 license.
  • Docs — ⚠️ Reachable but primarily in Chinese. The site does reference AI/LLM integration but content is largely inaccessible to English-speaking developers. The docs site mentions "低代码构建 AI 应用" (low-code AI application development).
  • Demo — ❌ Non-functional. The page loads blank with only a "Stuck? Press Ctrl + Shift + R to reload" message. No demo content is visible.

• Project Activity: Active. Last commit: May 18, 2026. Recent release: v1.14.3 (May 18, 2026). The project has 5,435 commits and shows regular development activity including AI-related features (A2A support, memory, model updates).

• Assessment: Erupt is a real, actively maintained project with genuine AI capabilities via its erupt-ai module. However, several claims in the description are inaccurate or significantly exaggerated:

  1. "50+ LLM providers" — ❌ Inaccurate. The erupt-ai/src/main/java/xyz/erupt/ai/llm directory contains 17 LLM provider implementations (ChatGpt, Claude, DeepSeek, Doubao, Fireworks, GLM, Gemini, Grok, Mimo, MiniMax, Mistral, Moonshot, Ollama, OpenAIAdapter, OpenRouter, Qwen, Together). The README itself only lists 4 (OpenAI, Claude, Gemini, Ollama). The "50+" claim is not supported by the code.

  2. "MCP-native tool calling (SSE & STDIO)" — ⚠️ Partially verified. MCP support exists via langchain4j-mcp dependency and AiMCPProp.java configuration, but "SSE & STDIO" transport details are not explicitly confirmed in the configuration code. This is likely inherited from LangChain4j's MCP implementation rather than being a native Erupt feature.

  3. "@AiToolbox" annotation — ✅ Verified. The AiToolboxManager.java class scans Spring beans annotated with @AiToolbox and exposes @Tool-annotated methods as AI-callable tools via reflection and LangChain4j integration.

  4. "A2A multi-agent workflows" — ✅ Verified. A2AAgentTools.java implements agent-to-agent delegation, and the POM includes the langchain4j-agentic-a2a dependency.

  5. "per-role tool access" — ⚠️ Not verified. An EruptUserTools.java file exists but its contents were not inspected. This claim cannot be confirmed.

  6. "Annotation-driven Java admin framework... with a built-in, fully UI-configurable AI harness" — ⚠️ Misleading framing. The description reads as though this is an AI framework, but Erupt is primarily an admin/CRUD framework. The AI module is a secondary feature. Other entries in this section (Spring AI, LangChain4j, Akka Agents, etc.) are AI-first frameworks. Erupt's primary purpose is generating admin UIs from JPA annotations.

• Recommendation: Include with changes — if the description is corrected to be accurate, or Exclude — if the maintainers decide this is too niche or tangential for the AI Frameworks section.

• Notes / Required Changes:

  1. Fix "50+ LLM providers" — Should say "17 LLM providers" or "multiple LLM providers" (the actual count in the codebase).

  2. Fix the demo link — https://demo.erupt.xyz is broken/non-functional. Either fix it or remove it from the links.

  3. Docs language note — The docs site is primarily in Chinese. Consider noting this or linking to the GitHub README (which has English content) as the primary documentation link instead.

  4. Reframe the description — The current description leads with "Annotation-driven Java admin framework" which is accurate, but then positions the AI features as the core value proposition. Since this is being added to the AI Frameworks section alongside Spring AI, LangChain4j, and dedicated agent frameworks, the description should be more transparent that AI is a module within a broader admin framework, not the primary purpose of the project.

  5. Consider categorization — Erupt may not belong in the AI Frameworks section alongside dedicated AI frameworks. It's an admin framework with an AI add-on module. It might be better suited to a different section, or the description should clearly convey this distinction.

  6. Suggested rewrite:

     Annotation-driven Java admin framework (Spring Boot 3) that includes an AI module built on LangChain4j. The erupt-ai module provides a UI-configurable AI harness with 17 LLM providers, MCP tool calling, A2A multi-agent workflows, and the ability to expose Spring beans as AI-callable tools via @AiToolbox. Apache-2.0.

---

Overall Recommendation: Include with changes

The project is real and actively maintained with genuine AI capabilities, but the description contains factual inaccuracies (particularly "50+ LLM providers" when there are 17), a broken demo link, and misleading framing that positions an admin framework as an AI framework. The description must be corrected before inclusion. The maintainers should also consider whether an admin framework with an AI module belongs in the AI Frameworks section alongside dedicated AI-first frameworks.

This review was generated automatically by evaluating the contribution against CONTRIBUTING.md guidelines.

[jamesward]

/regen

[github-actions]

✅ Site regenerated and pushed to this PR branch.