Skip to content
Back to search

solon-ai

Java AI application development framework (supports LLM-tool,skill; RAG; MCP; Agent-ReAct,Team-Agent). Compatible with java8 ~ java26. It can also be embedded in SpringBoot, jFinal, Vert.x, Quarkus, and other frameworks.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/opensolon/solon-ai with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/opensolon/solon-ai'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/opensolon--solon-ai/badge.svg)](/listings/opensolon--solon-ai)

HTML

<a href="/listings/opensolon--solon-ai"><img src="/api/listings/opensolon--solon-ai/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 394 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. [![MCP Toplist](https://mcptoplist.com/badge/mcp.so%2Fsolon-ai%2Fopensolon.svg)](https://mcptoplist.com/server/mcp.so%2Fsolon-ai%2Fopensolon)
  2. <h1 align="center" style="text-align:center;">
  3. <img src="solon_icon.png" width="128" />
  4. <br />
  5. Solon-AI
  6. </h1>
  7. <p align="center">
  8. <strong>Java LLM(tool, skill) & RAG & MCP & Agent(ReAct, Team) Application development framework</strong>
  9. <br/>
  10. <strong>Restraint, efficiency and openness</strong>
  11. <br/>
  12. <strong>It is the same type of development framework as LangChain, LangGraph and LlamaIndex</strong>
  13. </p>
  14. <p align="center">
  15. <a href="https://solon.noear.org/article/learn-solon-ai">https://solon.noear.org/article/learn-solon-ai</a>
  16. </p>
  17. <p align="center">
  18. <a href="https://deepwiki.com/opensolon/solon-ai"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
  19. <a target="_blank" href="https://central.sonatype.com/search?q=org.noear%3Asolon-parent">
  20. <img src="https://img.shields.io/maven-central/v/org.noear/solon.svg?label=Maven%20Central" alt="Maven" />
  21. </a>
  22. <a target="_blank" href="LICENSE">
  23. <img src="https://img.shields.io/:License-Apache2-blue.svg" alt="Apache 2" />
  24. </a>
  25. <a target="_blank" href="https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html">
  26. <img src="https://img.shields.io/badge/JDK-8-green.svg" alt="jdk-8" />
  27. </a>
  28. <a target="_blank" href="https://www.oracle.com/java/technologies/javase/jdk11-archive-downloads.html">
  29. <img src="https://img.shields.io/badge/JDK-11-green.svg" alt="jdk-11" />
  30. </a>
  31. <a target="_blank" href="https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html">
  32. <img src="https://img.shields.io/badge/JDK-17-green.svg" alt="jdk-17" />
  33. </a>
  34. <a target="_blank" href="https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html">
  35. <img src="https://img.shields.io/badge/JDK-21-green.svg" alt="jdk-21" />
  36. </a>
  37. <a target="_blank" href="https://www.oracle.com/java/technologies/downloads/">
  38. <img src="https://img.shields.io/badge/JDK-25-green.svg" alt="jdk-25" />
  39. </a>
  40. <br />
  41. <a target="_blank" href='https://gitee.com/opensolon/solon-ai/stargazers'>
  42. <img src='https://gitee.com/opensolon/solon-ai/badge/star.svg?theme=gvp' alt='gitee star'/>
  43. </a>
  44. <a target="_blank" href='https://github.com/opensolon/solon-ai/stargazers'>
  45. <img src="https://img.shields.io/github/stars/opensolon/solon-ai.svg?style=flat&logo=github" alt="github star"/>
  46. </a>
  47. <a target="_blank" href='https://gitcode.com/opensolon/solon-ai/stargazers'>
  48. <img src='https://gitcode.com/opensolon/solon-ai/star/badge.svg' alt='gitcode star'/>
  49. </a>
  50. </p>
  51. ##### Language: English | [中文](README_CN.md)
  52. <hr />
  53. ## 简介
  54. Solon AI is one of the core subprojects of the Solon project. It is a full-scenario Java AI development framework, which aims to deeply integrate LLM large model, RAG knowledge base, MCP protocol and Agent collaboration choreography.
  55. * Full use case support: fits perfectly into the Solon ecosystem and can be seamlessly integrated into frameworks like SpringBoot, Vert.X, Quarkus, etc.
  56. * Multi-model dialects: Adapt model differences by dialect using ChatModel's unified interface (OpenAI, Gemini, Claude, Ollama, DeepSeek, Dashscope, etc.).
  57. * Graph-driven orchestration: supports the transformation of Agent reasoning into observable and governable computation flow graphs.
  58. Examples of embeddings (including third-party frameworks) for solon-ai:
  59. * https://gitee.com/solonlab/solon-ai-mcp-embedded-examples
  60. * https://gitcode.com/solonlab/solon-ai-mcp-embedded-examples
  61. * https://github.com/solonlab/solon-ai-mcp-embedded-examples
  62. ## What types of applications can be developed?
  63. * General-purpose Autonomous Agents (e.g., Manus, OpenOperator)
  64. * Intelligent Assistants & RAG Knowledge Bases (e.g., Dify, Coze)
  65. * Multi-Agent Collaborative Orchestration (e.g., AutoGPT, MetaGPT)
  66. * Business-Driven Controlled Workflows (e.g., AI-enhanced DingTalk/Lark approvals, SAP Intelligent Modules)
  67. * Intelligent Document Processing & ETL (e.g., Instabase, Unstructured.io)
  68. * Real-time Data Insights & Dashboards (e.g., Text-to-SQL applications)
  69. * Automated Testing & Quality Assurance (e.g., GitHub Copilot Workspace)
  70. * Low-Code/Visual AI Workflow Platforms (e.g., LangFlow, Flowise)
  71. * And more...
  72. ## Example Agent synthesis project (can be used directly for production or customization)
  73. * [SolonCode (Java impl version of "Claude Code")](../../../../opensolon/soloncode)
  74. * [SolonClaw (Java impl version of "OpenClaw")](../../../../opensolon/solonclaw)
  75. ## Core Module Experience
  76. * ChatModel(General Purpose LLM call interface)
  77. Support for synchronous and Reactive calls, built-in dialect adaptation, Tool, Skill, ChatSession, etc.
  78. ```java
  79. ChatModel chatModel = ChatModel.of("http://127.0.0.1:11434/api/chat")
  80. .provider("ollama") //Need to specify vendor, used to identify interface style (also called dialect)
  81. .model("qwen2.5:1.5b")
  82. .defaultTalentAdd(new McpGatewayTalent())
  83. .build();
  84. // Synchronize the call and print the response message
  85. AssistantMessage result = ChatchatModel.prompt("The weather in Hangzhou today?")
  86. .options(op->op.toolAdd(new WeatherTools())) //Adding tools
  87. .call()
  88. .getMessage();
  89. System.out.println(result);
  90. // Stream call
  91. chatModel.prompt("hello").stream(); //Flux<ChatEvent>, full semantic events
  92. ```
  93. * Talents(Solon AI Talents)
  94. ```java
  95. Talent talent = new TalentDesc("order_expert")
  96. .description("Order Assistant")
  97. // Dynamic admission: Activated only when "order" is mentioned
  98. .isSupported(prompt -> prompt.getUserMessageContent().contains("order"))
  99. // Dynamic instructions: Inject different Sops depending on whether the user is a VIP or not
  100. .instruction(prompt -> {
  101. if ("VIP".equals(prompt.getMeta("user_level"))) {
  102. return "This is a VIP customer, please call fast_track_tool first.";
  103. }
  104. return "Process the order inquiry according to the normal process.";
  105. })
  106. .toolAdd(new OrderTools());
  107. chatModel.prompt("Where is my order from yesterday?")
  108. .options(o->o.talentAdd(talent))
  109. .call();
  110. ```
  111. * RAG(知识库)
  112. It provides full-link support from DocumentLoader, DocumentSplitter, EmbeddingModel, and RerankingModel.
  113. ```java
  114. //Building a Knowledge Warehouse
  115. EmbeddingModel embeddingModel = EmbeddingModel.of(apiUrl).apiKey(apiKey).provider(provider).model(model).batchSize(10).build();
  116. RerankingModel rerankingModel = RerankingModel.of(apiUrl).apiKey(apiKey).provider(provider).model(model).build();
  117. InMemoryRepository repository = new InMemoryRepository(TestUtils.getEmbeddingModel()); //3.初始化知识库
  118. repository.insert(new PdfLoader(pdfUri).load());
  119. //retrieval
  120. List<Document> docs = repository.search(query);
  121. //You can rearrange it if you want
  122. docs = rerankingModel.rerank(query, docs);
  123. //Cue enhancement is
  124. ChatMessage message = ChatMessage.ofUserAugment(query, docs);
  125. //Calling the llm
  126. chatModel.prompt(message)
  127. .call();
  128. ```
  129. * MCP (Model Context Protocol)
  130. Deep integration with MCP protocol (MCP_2025_06_18), supporting cross-platform tool, resource, and prompt sharing.
  131. ```java
  132. //server
  133. @McpServerEndpoint(channel = McpChannel.STREAMABLE, mcpEndpoint = "/mcp")
  134. public class MyMcpServer {
  135. @ToolMapping(description = "Checking the weather")
  136. public String getWeather(@Param(description = "city") String location) {
  137. return "It's sunny, 25 degrees";
  138. }
  139. }
  140. //client
  141. McpClientProvider clientProvider = McpClientProvider.builder()
  142. .channel(McpChannel.STREAMABLE)
  143. .url("http://localhost:8080/mcp")
  144. .build();
  145. ```
  146. * Agent (An Agent Experience with Computational Flow Graphs)
  147. The Solon AI Agent transforms reasoning logic into graph-driven collaboration flows, enabling ReAct introspective reasoning and multi-agent Team collaboration.
  148. ```java
  149. //Reflective intelligent agent:
  150. ReActAgent agent = ReActAgent.of(chatModel) // 或者用 SimpleAgent.of(chatModel)
  151. .name("weather_expert")
  152. .description("Check the weather and provide advice")
  153. .defaultToolAdd(weatherTool) // Inject MCP or local tools
  154. .build();
  155. agent.prompt("What to wear in Beijing today?").call(); // Autocomplete: Think -> Call tool -> Observe -> Summarize
  156. // Constructing a team agent: Automatically arranging member roles through protocols
  157. TeamAgent team = TeamAgent.of(chatModel)
  158. .name("marketing_team")
  159. .protocol(TeamProtocols.HIERARCHICAL) // Hierarchical collaboration (6 preset protocols)
  160. .agentAdd(copywriterAgent) // Copywriter expert
  161. .agentAdd(illustratorAgent) // Illustrator expert
  162. .build();
  163. team.prompt("Plan a promotion scheme for deep-sea mineral water").call(); // Supervisor automatically decomposes tasks and assigns them to corresponding experts .defaultToolAdd(weatherTool) // Inject MCP or local tools
  164. ```
  165. * Ai Flow(Process orchestration experience)
  166. The low-code flow application of Dify is simulated, and the links such as RAG, hint word enhancement and model call are YAML arranged.
  167. ```yaml
  168. id: demo1
  169. layout:
  170. - type: "start"
  171. - task: "@VarInput"
  172. meta:
  173. message: "Solon 是谁开发的?"
  174. - task: "@EmbeddingModel"
  175. meta:
  176. embeddingConfig: # "@type": "org.noear.solon.ai.embedding.EmbeddingConfig"
  177. provider: "ollama"
  178. model: "bge-m3"
  179. apiUrl: "http://127.0.0.1:11434/api/embed"
  180. - task: "@InMemoryRepository"
  181. meta:
  182. documentSources:
  183. - "https://solon.noear.org/article/about?format=md"
  184. splitPipeline:
  185. - "org.noear.solon.ai.rag.splitter.RegexTextSplitter"
  186. - "org.noear.solon.ai.rag.splitter.TokenSizeTextSplitter"
  187. - task: "@ChatModel"
  188. meta:
  189. systemPrompt: "你是个知识库"
  190. stream: false
  191. chatConfig: # "@type": "org.noear.solon.ai.chat.ChatConfig"
  192. provider: "ollama"
  193. model: "qwen2.5:1.5b"
  194. apiUrl: "http://127.0.0.1:11434/api/chat"
  195. - task: "@ConsoleOutput"
  196. # FlowEngine flowEngine = FlowEngine.newInstance();
  197. # ...
  198. # flowEngine.eval("demo1");
  199. ```
  200. ## Solon Project code repository
  201. | Code repository | Description |
  202. |-----------------------------------------------------------------------------|-----------------------------------------------------------------|
  203. | [/opensolon/solon](../../../../opensolon/solon) | Solon ,Main code repository |
  204. | [/opensolon/solon-examples](../../../../opensolon/solon-examples) | Solon ,Official website supporting sample code repository |
  205. | | |
  206. | [/opensolon/solon-ai](../../../../opensolon/solon-ai) | Solon Ai ,Code repository |
  207. | [/opensolon/solon-flow](../../../../opensolon/solon-flow) | Solon Flow ,Code repository |
  208. | [/opensolon/solon-expression](../../../../opensolon/solon-expression) | Solon Expression ,Code repository |
  209. | [/opensolon/solon-cloud](../../../../opensolon/solon-cloud) | Solon Cloud ,Code repository |
  210. | [/opensolon/solon-admin](../../../../opensolon/solon-admin) | Solon Admin ,Code repository |
  211. | [/opensolon/solon-integration](../../../../opensolon/solon-integration) | Solon Integration ,Code repository |
  212. | [/opensolon/solon-java17](../../../../opensolon/solon-java17) | Solon Java17 ,Code repository(base java17) |
  213. | [/opensolon/solon-java25](../../../../opensolon/solon-java25) | Solon Java25 ,Code repository(base java25) |
  214. | | |
  215. | [/opensolon/soloncode](../../../../opensolon/soloncode) | SolonCode(Java8 impl version of "Claude Code") ,Code repository |
  216. | [/opensolon/solonclaw](../../../../opensolon/solonclaw) | SolonClaw(Java8 impl version of "OpenClaw") ,Code repository |
  217. | | |
  218. | [/opensolon/solon-maven-plugin](../../../../opensolon/solon-gradle-plugin) | Solon Maven ,Plugin code repository |
  219. | [/opensolon/solon-gradle-plugin](../../../../opensolon/solon-gradle-plugin) | Solon Gradle ,Plugin code repository |
  220. | | |
  221. | [/opensolon/solon-idea-plugin](../../../../opensolon/solon-idea-plugin) | Solon Idea ,Plugin code repository |
  222. | [/opensolon/solon-vscode-plugin](../../../../opensolon/solon-vscode-plugin) | Solon VsCode ,Plugin code repository |
  223. ## FAQ
  224. ### What is Solon AI?
  225. Solon AI is a full-scenario Java AI development framework that deeply integrates LLM large models, RAG knowledge bases, MCP protocol, and Agent collaboration orchestration. It's designed for building production-grade AI applications with Java.
  226. ### How does Solon AI differ from Python frameworks like LangChain?
  227. Solon AI is built **specifically for Java developers** with seamless integration into the Java ecosystem:
  228. **Key differences:**
  229. - **Java-native**: Fits perfectly into Solon, SpringBoot, Vert.X, Quarkus ecosystems
  230. - **JDK 8-25 support**: Broad Java version compatibility
  231. - **Multi-model dialects**: Unified interface adapts model differences automatically
  232. - **Graph-driven orchestration**: Transforms Agent reasoning into observable computation flow graphs
  233. ### What components does Solon AI provide?
  234. - **ChatModel**: General-purpose LLM call interface with Tool, Skill, ChatSession support
  235. - **Skills**: Dynamic admission and instruction injection
  236. - **RAG**: Full-link support (DocumentLoader, DocumentSplitter, EmbeddingModel, RerankingModel)
  237. - **MCP**: Deep integration with Model Context Protocol (MCP_2025_06_18)
  238. - **Agent**: ReAct introspective reasoning and Team collaboration
  239. - **Ai Flow**: YAML-based flow orchestration (Dify-like low-code experience)
  240. ### What LLM providers are supported?
  241. Supported via dialect adaptation:
  242. - OpenAI, Gemini, Claude
  243. - Ollama (local models)
  244. - DeepSeek, Dashscope (Alibaba)
  245. - Custom endpoints
  246. ### How do I get started?
  247. Add Maven dependency:
  248. ```xml
  249. <dependency>
  250. <groupId>org.noear</groupId>
  251. <artifactId>solon-ai</artifactId>
  252. </dependency>
  253. ```
  254. Basic usage:
  255. ```java
  256. ChatModel chatModel = ChatModel.of("http://127.0.0.1:11434/api/chat")
  257. .provider("ollama")
  258. .model("qwen2.5:1.5b")
  259. .build();
  260. AssistantMessage result = chatModel.prompt("Hello").call().getMessage();
  261. ```
  262. ### How do I add tools?
  263. ```java
  264. chatModel.prompt("What's the weather?")
  265. .options(op -> op.toolAdd(new WeatherTools()))
  266. .call();
  267. ```
  268. ### How do I use RAG?
  269. ```java
  270. EmbeddingModel embeddingModel = EmbeddingModel.of(apiUrl)
  271. .apiKey(apiKey).provider(provider).model(model).build();
  272. InMemoryRepository repository = new InMemoryRepository(embeddingModel);
  273. repository.insert(new PdfLoader(pdfUri).load());
  274. List<Document> docs = repository.search(query);
  275. ChatMessage message = ChatMessage.ofUserAugment(query, docs);
  276. chatModel.prompt(message).call();
  277. ```
  278. ### What is MCP integration?
  279. Solon AI provides both MCP server and client:
  280. **Server:**
  281. ```java
  282. @McpServerEndpoint(channel = McpChannel.STREAMABLE, mcpEndpoint = "/mcp")
  283. public class MyMcpServer {
  284. @ToolMapping(description = "Checking the weather")
  285. public String getWeather(@Param(description = "city") String location) {
  286. return "It's sunny, 25 degrees";
  287. }
  288. }
  289. ```
  290. **Client:**
  291. ```java
  292. McpClientProvider client = McpClientProvider.builder()
  293. .channel(McpChannel.STREAMABLE)
  294. .url("http://localhost:8080/mcp")
  295. .build();
  296. ```
  297. ### What are the Agent patterns?
  298. - **ReActAgent**: Reflective agent with Think → Call → Observe → Summarize loop
  299. - **TeamAgent**: Multi-agent collaboration with 6 preset protocols (HIERARCHICAL, etc.)
  300. ### Where can I find help?
  301. - **Documentation**: [solon.noear.org/article/learn-solon-ai](https://solon.noear.org/article/learn-solon-ai)
  302. - **Examples**: [solonlab/solon-ai-mcp-embedded-examples](https://github.com/solonlab/solon-ai-mcp-embedded-examples)
  303. - **SolonCode**: Java version of "Claude Code" - [github.com/opensolon/soloncode](https://github.com/opensolon/soloncode)
  304. - **SolonClaw**: Java version of "OpenClaw" - [github.com/opensolon/solonclaw](https://github.com/opensolon/solonclaw)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.