# videoflow

**Repository Path**: qw515149/videoflow

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-12
- **Last Updated**: 2026-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VideoFlow AI - AI 视频生成工作流平台

> 可视化、可扩展的 AI 视频生成工作流编排系统

## 项目简介

VideoFlow AI 是一个开源的 AI 视频生成工作流平台，通过可视化的节点编辑器，让用户能够像搭积木一样构建复杂的视频生成流水线。

### 核心特性

- 🎨 **可视化编排** - 拖拽节点构建工作流，无需编程
- 🤖 **AI Agent 增强** - 内置智能分镜、剧本生成等 Agent
- 🔌 **多模型聚合** - 统一接入主流 AI 视频、图片、音频生成服务
- 🚀 **高性能执行** - 基于 LangGraph 的并行编排引擎
- 📦 **插件化架构** - 轻松扩展自定义节点
- 🐳 **一键部署** - Docker Compose 开箱即用

## 技术栈

- **后端**: Node.js 20 + TypeScript + Fastify + Prisma
- **前端**: React 18 + Vite + React Flow + Zustand
- **AI 框架**: LangChain.js + LangGraph.js + DeepAgent
- **数据库**: PostgreSQL 16 + Redis 7
- **存储**: MinIO (S3 兼容)
- **队列**: BullMQ

## 快速开始

### 前置要求

- Node.js 20+ (LTS)
- pnpm 8+
- Docker (WSL2 + Docker Engine 或 Podman)

### 1. 安装开发环境

**Windows 用户 (WSL2)**：参考 [WSL_DOCKER_SETUP.md](WSL_DOCKER_SETUP.md)

**其他系统**：确保 Docker 和 Docker Compose 已安装

### 2. 启动基础服务

```bash
# 在 WSL 里进入项目目录
cd /mnt/c/winmo

# 启动 PostgreSQL + Redis + MinIO
docker compose -f docker-compose.dev.yml up -d

# 查看运行状态
docker compose -f docker-compose.dev.yml ps
```

### 3. 验证服务

```bash
# PostgreSQL
docker exec -it videoflow-postgres psql -U videoflow -d videoflow_dev -c "SELECT version();"

# Redis
docker exec -it videoflow-redis redis-cli ping

# MinIO 控制台
# 浏览器打开: http://localhost:9001
# 用户名: minioadmin
# 密码: minioadmin
```

### 4. 安装项目依赖 (待开发)

```bash
# 安装 pnpm (如果未安装)
npm install -g pnpm

# 安装依赖
pnpm install

# 初始化数据库
pnpm db:migrate

# 启动开发服务器
pnpm dev
```

## 服务端口

| 服务 | 端口 | 用途 |
|------|------|------|
| PostgreSQL | 5432 | 主数据库 |
| Redis | 6379 | 缓存 + 队列 |
| MinIO API | 9000 | 对象存储 API |
| MinIO Console | 9001 | 对象存储管理界面 |
| API Server | 3000 | 后端 API (待开发) |
| Web App | 5173 | 前端应用 (待开发) |

## 常用命令

```bash
# 启动所有服务
docker compose -f docker-compose.dev.yml up -d

# 停止所有服务
docker compose -f docker-compose.dev.yml down

# 查看日志
docker compose -f docker-compose.dev.yml logs -f

# 重启某个服务
docker compose -f docker-compose.dev.yml restart postgres

# 清理数据（⚠️ 会删除所有数据）
docker compose -f docker-compose.dev.yml down -v
```

## 项目结构（规划中）

```
videoflow/
├── apps/
│   ├── web/              # 前端应用
│   ├── api/              # 后端 API
│   └── worker/           # 任务执行 Worker
├── packages/
│   ├── core/             # 核心类型
│   ├── engine/           # 工作流引擎
│   ├── agents/           # Agent 实现
│   ├── nodes/            # 节点库
│   └── providers/        # AI Provider 适配
├── docker/               # Docker 配置
├── docs/                 # 文档
└── docker-compose.dev.yml
```

## 文档

- [技术设计文档](TECHNICAL_DESIGN.md) - 完整的技术架构设计
- [WSL Docker 安装指南](WSL_DOCKER_SETUP.md) - Windows 环境配置

## 开发路线图

- [x] 项目架构设计
- [x] 基础设施配置（Docker）
- [ ] Monorepo 初始化
- [ ] 数据模型设计
- [ ] 工作流执行引擎
- [ ] 可视化编辑器
- [ ] 节点库实现
- [ ] Provider 集成

详见 [TECHNICAL_DESIGN.md](TECHNICAL_DESIGN.md) 第 10 章。

## 环境变量

复制 `.env.example` 为 `.env`（待创建）并配置：

```bash
# Database
DATABASE_URL=postgresql://videoflow:dev123@localhost:5432/videoflow_dev

# Redis
REDIS_URL=redis://localhost:6379

# MinIO
MINIO_ENDPOINT=localhost
MINIO_PORT=9000
MINIO_ACCESS_KEY=minioadmin
MINIO_SECRET_KEY=minioadmin
MINIO_BUCKET=videoflow-assets

# AI Providers (可选，开发期可用 Mock)
ANTHROPIC_API_KEY=
OPENAI_API_KEY=
```

## 故障排查

### Docker 服务无法启动

```bash
# WSL 里重启 Docker
sudo service docker restart

# 或者重启 WSL
wsl --shutdown  # 在 Windows CMD 里执行
wsl
```

### 端口被占用

修改 `docker-compose.dev.yml` 里的端口映射，例如：

```yaml
ports:
  - "15432:5432"  # 改成 15432
```

### 国内网络拉取镜像慢

配置 Docker 镜像加速，参考 [WSL_DOCKER_SETUP.md](WSL_DOCKER_SETUP.md) 第六步。

## License

MIT

## 联系方式

- Issues: [GitHub Issues](https://github.com/your-repo/videoflow-ai/issues)
- Discussions: [GitHub Discussions](https://github.com/your-repo/videoflow-ai/discussions)

---

**状态**：🚧 早期开发阶段，欢迎参与贡献！