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.75
MAX_ITERATIONS = 3

# Agent 工具配置
UNDERSTANDING_TOOLS = [...]
PLANNING_TOOLS = [...]
GENERATION_TOOLS = [...]
EVALUATION_TOOLS = [...]

模型配置

在 .env 中配置不同模型：

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

🎯 路线图

✅ MVP (当前)

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

🚧 V1.0

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

🔮 未来

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

🤝 贡献

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

📄 许可证

MIT License