# kouzi

**Repository Path**: nachao/kouzi

## Basic Information

- **Project Name**: kouzi
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-03
- **Last Updated**: 2026-01-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI工作流系统

一个基于FastAPI和React的多模型AI工作流编排系统，支持可视化设计工作流，串联多个AI模型完成复杂任务。

## 项目结构

```
.
├── backend/          # 后端服务（FastAPI）
│   ├── app/
│   │   ├── api/      # API路由
│   │   ├── models.py # 数据模型
│   │   ├── schemas.py # Pydantic模型
│   │   ├── services/ # 业务逻辑
│   │   └── main.py  # 应用入口
│   ├── requirements.txt
│   └── README.md
├── frontend/         # 前端应用（React）
│   ├── src/
│   │   ├── components/
│   │   ├── api/
│   │   └── App.tsx
│   ├── package.json
│   └── README.md
├── start_backend.sh  # 启动后端脚本
├── start_frontend.sh # 启动前端脚本
├── init_backend.sh   # 初始化后端脚本
└── README.md
```

## 功能特性

### 后端
- ✅ 工作流CRUD操作
- ✅ 工作流执行引擎
- ✅ 多模型支持（OpenAI、DeepSeek、豆包等）
- ✅ 执行记录追踪
- ✅ SQLite数据库存储
- ✅ RESTful API

### 前端
- ✅ 可视化工作流设计器
- ✅ 拖拽式节点编辑
- ✅ 工作流保存和加载
- ✅ 工作流执行
- ✅ 执行记录查看
- ✅ 模型配置管理

## 快速开始

### 方式一：使用脚本（推荐）

```bash
# 1. 初始化后端（首次运行）
./init_backend.sh

# 2. 启动后端（新终端窗口）
./start_backend.sh

# 3. 启动前端（新终端窗口）
./start_frontend.sh
```

### 方式二：手动启动

#### 1. 后端设置

```bash
cd backend

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp env.template .env
# 编辑 .env 文件，填入API密钥

# 初始化数据库
python init_db.py

# 启动服务
python -m uvicorn app.main:app --reload
```

后端将在 `http://localhost:8000` 启动

#### 2. 前端设置

```bash
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

前端将在 `http://localhost:3000` 启动

### 3. 访问应用

- 前端界面: http://localhost:3000
- API文档: http://localhost:8000/docs

## 使用说明

### 创建工作流

1. 在前端界面点击"工作流设计"
2. 点击"添加节点"选择节点类型
3. 拖拽节点进行连接
4. 配置每个节点的参数
5. 点击"保存"保存工作流

### 执行工作流

1. 选择已保存的工作流
2. 点击"执行"按钮
3. 输入执行参数（JSON格式）
4. 查看执行结果

### 配置模型

1. 进入"模型配置"页面
2. 添加模型配置（名称、类型、提供商等）
3. 在工作流中使用配置的模型

## API端点

### 工作流管理
- `GET /api/workflows` - 获取工作流列表
- `GET /api/workflows/{id}` - 获取单个工作流
- `POST /api/workflows` - 创建工作流
- `PUT /api/workflows/{id}` - 更新工作流
- `DELETE /api/workflows/{id}` - 删除工作流
- `POST /api/workflows/{id}/execute` - 执行工作流

### 执行记录
- `GET /api/executions` - 获取执行记录列表
- `GET /api/executions/{id}` - 获取单个执行记录

### 模型配置
- `GET /api/models` - 获取模型配置列表
- `POST /api/models` - 创建模型配置

## 技术栈

### 后端
- FastAPI - Web框架
- SQLAlchemy - ORM
- SQLite - 数据库
- Pydantic - 数据验证

### 前端
- React 18
- TypeScript
- Vite
- ReactFlow - 工作流可视化
- Ant Design - UI组件库

## 开发计划

- [ ] 支持更多模型（图片生成、视频生成）
- [ ] 工作流模板
- [ ] 批量执行
- [ ] 执行结果缓存
- [ ] 用户认证
- [ ] 工作流版本管理

## 许可证

MIT