# Z-Image-TurboWebUI整合版

**Repository Path**: avenjan/Z-Image-Turbo-Webui

## Basic Information

- **Project Name**: Z-Image-TurboWebUI整合版
- **Description**: Z-Image-Turbo WebUI 整合版是基于阿里通义实验室开源Z-Image-Turbo文生图模型打造的开箱即用、极速出图的 AI 绘画一体化工具，专为降低 AI 绘画门槛、提升创作效率设计，兼顾新手易用性与专业创作需求。
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-30
- **Last Updated**: 2026-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Z-Image-Turbo AI 灵感工坊 v9.0
## 🔥 本地极速AI绘画WebUI整合版 | 开箱即用 | 一键启动

## 项目简介
**Z-Image-Turbo AI 灵感工坊 v9.0** 是基于 DiffSynth 框架打造的**本地私有化AI绘画WebUI整合包**，无需复杂环境配置，解压即用，一键启动Web界面。
搭载 Turbo 极速生成模型，**8步即可生成高清画质**，支持多LoRA混合、作品库管理、分类标签、批量操作，全程本地运行，绝对隐私安全。

---

## ✨ 核心特性
- 🚀 **极速生成**：Turbo模型8步出图，速度远超传统Stable Diffusion
- 🎨 **开箱即用**：完整Python环境+依赖一键整合，无需手动安装
- 🖥️ **本地私有化**：所有数据、图片、模型本地存储，不上传云端
- 🧩 **多LoRA支持**：可同时加载多个LoRA，自由混搭创作风格
- 📂 **作品库管理**：自动存档生成记录，支持分类、标签、检索、批量操作
- 📊 **可视化进度**：实时显示生成步数、耗时、完成率、批量进度
- 🔐 **密码登录**：独立访问密码，保护本地创作隐私
- 📱 **最优分辨率**：内置64倍标准分辨率，人像/风景/插画全覆盖
- 🎯 **参数容错**：空值自动兜底，运行稳定，不易崩溃
- 🌐 **美观WebUI**：现代化界面，操作简单，支持大图预览、参数复制

---

## 📥 下载与安装
### 1. 下载整合包
前往 Releases 下载最新 **Z-Image-Turbo-Studio_整合包** 压缩包

### 2. 解压运行
- 解压整合包到**英文路径**（建议：`D:\AI\DiffSynth-Studio_整合包\`）
- **路径不能包含中文、空格、特殊字符**
- 双击 `start.bat` 一键启动

---

## 🚀 快速启动
### 方式1：一键启动（推荐）
1. 进入整合包目录
2. 双击 **`start.bat`**
3. 等待模型加载完成 → 自动打开浏览器
4. 输入密码登录 → 开始创作

### 方式2：手动启动（PowerShell）
```powershell
cd D:\DiffSynth-Studio_整合包
.\python\python.exe webui.py
```

---

## ⚙️ 配置说明
### 核心配置文件：`config.py`
可自定义：
- 访问密码 `PASSWORD`
- 监听地址 `HOST` / 端口 `PORT`
- 模型目录 `MODEL_DIR`
- 显存限制 `VRAM_LIMIT`
- LoRA 列表 `LORA_LIST`
- 自动打开浏览器 `AUTO_OPEN_BROWSER`

---

## 🎯 使用指南
### 1. 灵感工坊（主生成页面）
- **正向提示词**：描述画面内容、风格、画质、构图
- **负面提示词**：排除模糊、低质、畸形、水印、多余肢体
- **随机种子**：固定种子可复现相同画面
- **CFG**：提示词遵循强度，建议 1.0~2.0
- **迭代步数**：Turbo模型建议 4~10 步，默认8步最佳
- **分辨率**：内置最优竖屏/横屏/正方形比例
- **批量生成**：一次生成1~10张

### 2. 创意档案（作品管理）
- 查看所有历史作品
- 按分类、标签筛选
- 单张/批量下载、删除
- 查看完整生成参数（提示词、种子、CFG、步数）
- 编辑分类与标签
- 大图预览 + 键盘左右切换

### 3. 关于系统
查看版本信息、运行环境、使用说明

---

## 🧾 推荐参数
- 迭代步数：**8**
- CFG：**1.8**
- 分辨率：**928×1664（默认竖屏）**
- 种子：**42**（基准种子）

---

## 🧰 系统要求
### 最低配置
- 显卡：NVIDIA GTX 1660 / 1050Ti 4G
- 显存：≥4GB
- 系统：Windows 10/11 64位
- 硬盘：≥10GB空闲空间

### 推荐配置
- 显卡：NVIDIA RTX 3060 / 3070 / 4060及以上
- 显存：≥6GB
- 内存：≥16GB

---

## 📌 注意事项
1. **路径必须全英文**，不能有中文、空格、特殊符号
2. 首次启动会加载模型，耗时稍长（1~3分钟）
3. 生成过程中不要关闭终端窗口
4. 所有生成图片保存在 `output/` 目录
5. 作品数据保存在 `image_library.db`（SQLite）
6. 模型文件请放入指定模型目录，并在 `config.py` 中配置路径

---

## 📁 项目目录结构
```
DiffSynth-Studio_整合包/
├── DiffSynth-Studio/    # 核心推理框架
├── python/              # 集成Python环境
├── output/              # 生成图片保存目录
├── config.py            # 配置文件
├── webui.py             # WebUI主程序
├── requirements.txt     # 依赖列表
├── image_library.db     # 作品数据库
└── start.bat            # 一键启动脚本
```

---

## 🛠 常见问题
### Q1：启动报错，找不到模块
- 检查路径是否为**纯英文无空格**
- 重新解压整合包

### Q2：模型加载失败
- 确认模型路径配置正确
- 检查模型文件是否完整

### Q3：显存不足 OutOfMemory
- 降低分辨率
- 减少批量数量
- 在 `config.py` 中调低 `VRAM_LIMIT`

### Q4：浏览器无法打开
- 手动访问：`http://127.0.0.1:端口`
- 检查防火墙是否拦截

---

## 📝 更新日志
### v9.0（当前版本）
- 全新现代化UI界面
- 优化生成速度与稳定性
- 新增作品分类、标签系统
- 新增批量下载、批量删除
- 新增图片信息编辑
- 修复图片缩放、拖拽、翻页逻辑
- 统一弹窗样式，提升交互体验
- 完善登录权限控制

---

## 🤝 开源协议
本项目基于开源协议发布，**仅供个人学习、研究、非商业使用**
禁止未经授权用于商业用途、二次售卖、盗版分发

---

## 🌐 相关链接
- 作者官网：[https://www.cnuu.net](https://www.cnuu.net)
- 基于框架：[DiffSynth-Studio](https://github.com/modelscope/DiffSynth-Studio)

---

## 💡 致谢
- DiffSynth-Studio 开发团队
- 通义万相 TONGYI-MAI 模型
- 所有支持开源的用户