# jflux-flow

**Repository Path**: jflux/jflux-flow

## Basic Information

- **Project Name**: jflux-flow
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: LGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-07
- **Last Updated**: 2026-01-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# JFlux-Flow

<div align="center">

![JFlux-Flow](https://img.shields.io/badge/JFlux--Flow-1.0.1-brightgreen)
![Java](https://img.shields.io/badge/Java-17+-orange)
![License](https://img.shields.io/badge/License-LGPL%20v3.0-blue)

**Java 智能体编排解决方案**

[English](README.en.md) | 简体中文

</div>

---

## 简介

JFlux-Flow 是一个使用 Java 开发的智能体编排解决方案，它不是一个产品，而是一个开发组件。通过集成 JFlux-Flow，您可以使得任何传统的 Java Web 应用，具备 AI 智能体流程编排的能力。

## 特性

- **轻量级**：支持 Java 17 及以上版本，不限制开发框架，可以轻松集成到任何 Java 项目中
- **灵活高效**：内置丰富的节点类型，支持同步或异步执行，满足复杂的业务场景需求
- **高性能**：基于 Java 开发，充分利用 JVM 优势，性能比 Node.js 和 Python 更快
- **多 AI 集成**：支持多种 AI 框架，包括 LangChain4j、Spring AI 和 Solon AI
- **可视化编排**：配合前端拖拽组件，实现可视化的流程设计
- **易于扩展**：模块化设计，支持自定义节点类型和扩展插件

## 模块架构

JFlux-Flow 采用模块化设计，包含以下核心模块：

| 模块 | 说明 |
|------|------|
| kernel-core | 核心模块，提供流程编排基础能力 |
| kernel-node | 内置节点类型，包含常用流程节点 |
| kernel-springai | Spring AI 集成模块 |
| kernel-langchain4j | LangChain4j 集成模块 |
| kernel-solonai | Solon AI 集成模块 |
| kernel-flow | 流程编排主模块 |

## 快速开始

### 1. 添加依赖

在您的项目中添加 JFlux-Flow 依赖：

```xml
<dependency>
    <groupId>org.jflux</groupId>
    <artifactId>kernel-core</artifactId>
    <version>1.0.1</version>
</dependency>
```

### 2. 初始化流程

```java
import org.jflux.JFluxFlow;

// 从前端传递的流程数据
String flowDataJson = "{...}";

// 创建流程实例
JFluxFlow flow = new JFluxFlow(flowDataJson);

// 准备流程变量
Map<String, Object> variables = new HashMap<>();
variables.put("name", "张三");
variables.put("age", 18);

// 执行流程
flow.execute(variables);
```

### 3. 高级使用

#### 集成 Spring AI

```xml
<dependency>
    <groupId>org.jflux</groupId>
    <artifactId>kernel-springai</artifactId>
    <version>1.0.1</version>
</dependency>
```

#### 集成 LangChain4j

```xml
<dependency>
    <groupId>org.jflux</groupId>
    <artifactId>kernel-langchain4j</artifactId>
    <version>1.0.1</version>
</dependency>
```

## 前端组件

JFlux-Flow 配合前端拖拽组件 `flow` 使用，提供可视化的流程设计能力。

- **开源地址**：https://gitee.com/jflux/jflux-flow
- **功能特点**：拖拽式流程设计、丰富的节点类型、实时预览、支持导出

## 技术栈

- **Java**：17+
- **构建工具**：Maven 3.6+
- **核心依赖**：
  - FastJSON 2.0.58
  - OkHttp 4.9.3
  - Enjoy 5.1.3
  - GraalVM JavaScript 21.3.3.1
- **AI 框架**：
  - LangChain4j 1.7.1
  - Spring AI 1.0.0-M6

## 文档

详细的使用文档和 API 说明，请参考：

- [快速开始指南](docs/quickstart.md)
- [节点类型说明](docs/nodes.md)
- [API 文档](docs/api.md)

## 示例

更多示例代码请参考 [examples](examples) 目录。

## 贡献

欢迎贡献代码！请遵循以下步骤：

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 许可证

本项目采用 [GNU Lesser General Public License v3.0](LICENSE) 开源协议。

## 作者

- **开发者**：Corsak
- **邮箱**：corsak@qq.com

## 致谢

感谢所有贡献者和使用者的支持！

---

<div align="center">

如果这个项目对您有帮助，请给个 ⭐️ Star 支持一下！

Made with ❤️ by JFlux Develop Team

</div>