$git clone https://github.com/LnYo-Cly/ai4j当前仓库已经演进为多模块 SDK,除核心 ai4j 外,还提供 ai4j-extension-api、ai4j-plugin-ask-user、ai4j-agent、ai4j-coding、ai4j-cli、ai4j-spring-boot-starter、ai4j-flowgram-spring-boot-starter、ai4j-bom。如果只需要基础大模型调用,优先引入 ai4j;如果需要插件包、Agent、Coding Agent、CLI / ACP、Spring Boot 或 FlowGram 集成,再按
| 1 | <p align="center"> |
| 2 | <img src="https://capsule-render.vercel.app/api?type=waving&color=0:6A5ACD,100:2E86C1&height=180§ion=header&text=ai4j&fontSize=46&fontColor=ffffff&animation=fadeIn&desc=Java%20AI%20Agentic%20SDK%20for%20JDK%208%2B&descAlignY=68" alt="ai4j banner" /> |
| 3 | </p> |
| 4 | |
| 5 | <p align="center"> |
| 6 | <a href="https://search.maven.org/artifact/io.github.lnyo-cly/ai4j"> |
| 7 | <img src="https://img.shields.io/maven-central/v/io.github.lnyo-cly/ai4j?color=2E86C1&label=Maven%20Central" alt="Maven Central" /> |
| 8 | </a> |
| 9 | <a href="https://lnyo-cly.github.io/ai4j/"> |
| 10 | <img src="https://img.shields.io/badge/Docs-GitHub%20Pages-0A7EA4" alt="Docs" /> |
| 11 | </a> |
| 12 | <a href="https://www.apache.org/licenses/LICENSE-2.0.txt"> |
| 13 | <img src="https://img.shields.io/badge/License-Apache%202.0-1F6FEB" alt="License" /> |
| 14 | </a> |
| 15 | <img src="https://img.shields.io/badge/JDK-8%2B-2EA043" alt="JDK 8+" /> |
| 16 | <img src="https://img.shields.io/badge/Agentic-Enabled-6F42C1" alt="Agentic Enabled" /> |
| 17 | <img src="https://img.shields.io/badge/MCP-Supported-0F766E" alt="MCP Supported" /> |
| 18 | <img src="https://img.shields.io/badge/RAG-Built--in-B45309" alt="RAG Built-in" /> |
| 19 | <img src="https://img.shields.io/badge/CLI%20%2F%20TUI%20%2F%20ACP-Built--in-475569" alt="CLI TUI ACP Built-in" /> |
| 20 | </p> |
| 21 | |
| 22 | # ai4j |
| 23 | 一款面向 JDK8+ 的 Java AI Agentic 开发套件,既提供统一的大模型调用与常用 AI 基座能力,也提供更完善的智能体式 Agent 开发能力。 |
| 24 | 覆盖多平台模型接入、统一输入输出、Tool Call、MCP、RAG、统一 `VectorStore`、ChatMemory、Agent Runtime、Coding Agent、CLI / TUI / ACP、FlowGram 集成,以及 Dify / Coze / n8n 等已发布 AgentFlow 端点接入能力,帮助 Java 应用从基础模型接入扩展到更完整的 agentic 应用开发。 |
| 25 | |
| 26 | 当前仓库已经演进为多模块 SDK,除核心 `ai4j` 外,还提供 `ai4j-extension-api`、`ai4j-plugin-ask-user`、`ai4j-agent`、`ai4j-coding`、`ai4j-cli`、`ai4j-spring-boot-starter`、`ai4j-flowgram-spring-boot-starter`、`ai4j-bom`。如果只需要基础大模型调用,优先引入 `ai4j`;如果需要插件包、Agent、Coding Agent、CLI / ACP、Spring Boot 或 FlowGram 集成,再按模块引入对应能力。 |
| 27 | |
| 28 | ## README 导航 |
| 29 | |
| 30 | - [快速选择](#快速选择) |
| 31 | - [安装片段](#安装片段) |
| 32 | - [项目定位与对比](#适用场景与常见方案对比) |
| 33 | - [赞助商](#赞助商) |
| 34 | - [官方文档站](#官方文档站) |
| 35 | - [详细文档](#详细文档) |
| 36 | - [English README](README-EN.md) |
| 37 | |
| 38 | ## 快速选择 |
| 39 | |
| 40 | | 你要做什么 | 入口 | |
| 41 | | --- | --- | |
| 42 | | 先跑通第一条请求 | [快速开始](docs/readme/zh/quick-start.md) | |
| 43 | | 使用 Chat / streaming / vision / function call / memory | [Chat 服务](docs/readme/zh/chat.md) | |
| 44 | | 使用 Embedding、Rerank、RAG、混合检索 | [Embedding / Rerank / RAG](docs/readme/zh/rag-and-retrieval.md) | |
| 45 | | 使用 Coding Agent CLI / TUI / ACP | [Coding Agent CLI / TUI](docs/readme/zh/coding-agent-cli.md) | |
| 46 | | 使用联网增强或 Spring Boot | [内置联网与 Spring 应用](docs/readme/zh/network-and-spring.md) | |
| 47 | | 查看历史发布变化 | [更新日志](docs/readme/zh/changelog.md) | |
| 48 | | 贡献、赞助、贡献者 | [贡献与支持](docs/readme/zh/contributing-support.md) | |
| 49 | |
| 50 | ## 安装片段 |
| 51 | |
| 52 | Gradle: |
| 53 | |
| 54 | ```gradle |
| 55 | implementation 'io.github.lnyo-cly:ai4j:2.4.1' |
| 56 | ``` |
| 57 | |
| 58 | Maven: |
| 59 | |
| 60 | ```xml |
| 61 | <dependency> |
| 62 | <groupId>io.github.lnyo-cly</groupId> |
| 63 | <artifactId>ai4j</artifactId> |
| 64 | <version>2.4.1</version> |
| 65 | </dependency> |
| 66 | ``` |
| 67 | |
| 68 | 更多模块选型、Spring Boot 配置和调用示例见:[快速开始](docs/readme/zh/quick-start.md)。 |
| 69 | |
| 70 | ## 赞助商 |
| 71 | |
| 72 | + [TroveBox AI 中转平台](https://codex.trovebox.online/):提供 AI API 中转服务,低至 0.1x 倍率。 |
| 73 | |
| 74 | ## 适用场景与常见方案对比 |
| 75 | |
| 76 | | 方案 | Java 基线 | 应用形态 | 能力侧重点 | |
| 77 | | --- | --- | --- | --- | |
| 78 | | `ai4j` | `JDK8+` | 普通 Java / Spring | 统一大模型接入、Tool / MCP / RAG、Agent Runtime、Coding Agent、CLI / TUI / ACP | |
| 79 | | `Spring AI` | `Java 17+` | `Spring Boot 3.x` | Spring 原生 AI 集成、模型访问、Tool Calling、MCP、RAG | |
| 80 | | `Spring AI Alibaba` | `Java 17+` | `Spring Boot 3.x` | Spring 与阿里云 AI 生态整合 | |
| 81 | | `LangChain4j` | `Java 17+` | 普通 Java / Spring / Quarkus 等 | 通用 Java LLM / Agent / RAG 抽象、AI Services、多框架集成 | |
| 82 | |
| 83 | ## 支持的平台 |
| 84 | + OpenAI / OpenAI-compatible |
| 85 | + Anthropic / Anthropic-compatible Messages |
| 86 | + DashScope(阿里云百炼 / 通义) |
| 87 | + Doubao(火山方舟 / 豆包) |
| 88 | + Jina(Rerank / Jina-compatible Rerank) |
| 89 | + Zhipu(智谱) |
| 90 | + DeepSeek(深度求索) |
| 91 | + Moonshot(月之暗面) |
| 92 | + Hunyuan(腾讯混元) |
| 93 | + Lingyi(零一万物) |
| 94 | + Ollama |
| 95 | + MiniMax |
| 96 | + Baichuan |
| 97 | + Suno |
| 98 | |
| 99 | ## 支持的服务 |
| 100 | + Chat Completions(流式与非流式) |
| 101 | + Responses |
| 102 | + Anthropic Messages |
| 103 | + Embedding |
| 104 | + Rerank |
| 105 | + Audio |
| 106 | + Image |
| 107 | + Video |
| 108 | + Realtime |
| 109 | + Music(Suno 任务式生成) |
| 110 | |
| 111 | ## 已适配的 AgentFlow / 工作流平台 |
| 112 | + Dify(Chat / Workflow) |
| 113 | + Coze(Chat / Workflow) |
| 114 | + n8n(Webhook Workflow) |
| 115 | |
| 116 | ## 特性 |
| 117 | + 支持MCP服务,内置MCP网关,支持建立动态MCP数据源。 |
| 118 | + |