Jazz - AI 设计师 Agent 🎨

Jazz 是一个基于多 Agent 协作的 AI 设计助手，通过自然语言输入自动生成高质量的设计作品。

🌟 核心特性

• 多 Agent 协作: 5 个智能 Agent 协同工作（理解、规划、生成、评估、协调）
• 动态决策树: 基于 LangGraph 的智能路由和决策
• 上下文记忆: 使用 Mem0 管理对话历史和设计偏好
• 实时反馈: SSE 流式通信，实时展示生成进度
• 模型扩展: 支持多种 AI 模型

🏗️ 技术架构

前端

• 框架: React 18 + TypeScript
• UI: Tailwind CSS + Headless UI
• 状态管理: Redux Toolkit
• 构建工具: Vite

后端

• 框架: FastAPI (Python 3.11+)
• Agent 框架: LangGraph
• AI 模型: doubao (推理) + seedream (图像生成)
• 数据库: PostgreSQL + Redis
• 向量数据库: Qdrant

📦 Multi-Agent 架构

┌─────────────────────────────────────────┐
│ Orchestrator Agent │
│ (任务协调和调度) │
└───────────┬─────────────────────────────┘
│
┌───────┼───────┬───────────┬─────────┐
│ │ │ │ │
▼ ▼ ▼ ▼ ▼
┌────────┐ ┌────┐ ┌──────┐ ┌────────┐ ┌────────┐
│ Under- │→│Plan│→│Gene- │→│Evalua- │→│ Done │
│standing│ │ning│ │ration│ │tion │ │ │
└────────┘ └────┘ └──────┘ └────────┘ └────────┘
▲ │
└──────────┘
(质量不达标则重试)

🚀 快速开始

前置要求

• Docker & Docker Compose
• Node.js 18+
• Python 3.11+
• Doubao API Key
• SeedDream API Key

1. 克隆项目

cd open-jazz-agent

2. 配置环境变量

cp .env.example .env
# 编辑 .env 文件，填入你的 API Keys

3. 启动服务（使用 Docker）

# 启动所有服务
docker-compose up -d
# 查看日志
docker-compose logs -f

服务启动后：

• 前端: http://localhost:5173
• 后端 API: http://localhost:8000
• API 文档: http://localhost:8000/docs
• Qdrant Dashboard: http://localhost:6333/dashboard

4. 本地开发（不使用 Docker）

后端

cd backend
# 创建虚拟环境
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate# 安装依赖
pip install -r requirements.txt
# 启动后端
uvicorn app.main:app --reload --port 8000

前端

cd frontend
# 安装依赖
npm install
# 启动开发服务器
npm run dev

📚 API 文档

生成设计

POST/api/v1/design/generate

{
"prompt": "设计一个现代科技感的海报",
"model": "seeddream",
"config": {
"width": 1024,
"height": 1024,
"steps": 50,
"guidance_scale": 7.5
}
}

响应 (SSE 流式)

data: {"stage": "understanding", "message": "正在理解您的需求...", "progress": 10}
data: {"stage": "planning", "message": "正在规划设计方案...", "progress": 30}
data: {"stage": "generation", "message": "正在生成图像...", "progress": 60}
data: {"stage": "evaluation", "message": "正在评估质量...", "progress": 90}
data: {"stage": "complete", "result": {...}, "progress": 100}

📁 项目结构

open-jazz-agent/
├── frontend/ # React 前端
│ ├── src/
│ │ ├── components/ # UI 组件
│ │ ├── hooks/ # 自定义 Hooks
│ │ ├── services/ # API 服务
│ │ ├── store/ # Redux Store
│ │ └── types/ # TypeScript 类型
│ └── package.json
│
├── backend/ # Python 后端
│ ├── app/
│ │ ├── agents/ # Multi-Agent 实现
│ │ ├── graph/ # Graph 定义
│ │ ├── models/ # 模型适配器
│ │ ├── tools/ # Agent 工具集
│ │ ├── memory/ # Mem 管理
│ │ ├── api/ # FastAPI 路由
│ │ └── core/ # 核心配置
│ └── requirements.txt
│
├── docker-compose.yml
├── .env.example
└── README.md

🔧 配置说明

Agent 配置

在 backend/app/core/config.py 中调整：

# 评估标准QUALITY_THRESHOLD=0.75MAX_ITERATIONS=3# Agent 工具配置UNDERSTANDING_TOOLS= [...]
PLANNING_TOOLS= [...]
GENERATION_TOOLS= [...]
EVALUATION_TOOLS= [...]

模型配置

在 .env 中配置不同模型：

DOUBAO_MODEL=doubao-seed-1-6-thinking-250715SEEDDREAM_MODEL=doubao-seedream-4-0-250828

🎯 路线图

✅ MVP (当前)

• Multi-Agent 协作系统
• Doubao + SeedDream 集成
• 实时流式反馈
• 基础 UI 界面
• 文生图、图生图、画板魔法生图

🚧 V1.0

• 用户系统和认证
• 项目管理功能
• 模板库
• 批量生成
• 高级编辑功能

🔮 未来

• 更多 AI 模型支持
• 协作和分享功能
• 移动端适配
• 插件生态系统

🤝 贡献

欢迎贡献代码、报告问题或提出建议！

📄 许可证

MIT License