Art Agent MVP
AI 美术资源生成助手 — 通过对话生成游戏美术资源。
快速开始
1. 准备 API Key
你需要两个 API Key：
- OpenAI API Key：https://platform.openai.com/api-keys
- Replicate API Token：https://replicate.com/account/api-tokens
2. 启动后端
cd art-agent/backend
# 创建虚拟环境（推荐）
python -m venv venv
venv\Scripts\activate # Windows
# source venv/bin/activate # macOS/Linux
# 安装依赖
pip install -r requirements.txt
# 配置环境变量
copy .env.example .env
# 编辑 .env，填入你的 API Key
# 启动
uvicorn app.main:app --reload --port 8000
3. 启动前端
cd art-agent/frontend
# 安装依赖（需要 Node.js >= 18）
npm install
# 启动
npm run dev
4. 使用
打开浏览器访问 http://localhost:3000
- 输入文字描述你想要的美术资源
- 可以上传参考图引导风格
- 生成的图片可以点击"保存"按钮下载
- 持续对话进行迭代修改
项目结构
art-agent/
backend/ # Python FastAPI 后端
app/
main.py # 入口
api/chat.py # 对话 API
agent/ # Agent Loop 核心
services/ # AI 服务封装
frontend/ # Next.js 前端
src/
app/ # 页面
components/ # UI 组件
lib/ # 工具函数
docs/ # 文档
技术栈
- 前端：Next.js + TypeScript + Tailwind CSS
- 后端：Python FastAPI + SSE
- AI：OpenAI GPT-4o-mini（对话）+ Replicate Flux（图像生成）