# z-turbo-ui

**Repository Path**: yunstabc/z-turbo-ui

## Basic Information

- **Project Name**: z-turbo-ui
- **Description**: z-turbo-ui 是一个专门为极速图像生成模型（如 Z-Image-Turbo）设计的轻量级、响应式前端交互界面。该项目旨在为用户提供一个“零门槛”的 AI 创作体验
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-12-18
- **Last Updated**: 2026-01-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# z-turbo-ui 🚀
z-turbo-ui 是一个专为极速图像生成模型（如 Z-Image-Turbo）设计的轻量级、响应式 Web 交互界面。本项目深度适配 NVIDIA 最新 RTX 50 系列 (Blackwell) 显卡，旨在为用户提供亚秒级的 AI 创作体验。

## 🌟 核心特性

- ⚡ 极致性能：深度适配 RTX 5060/5090，支持 CUDA 12.8 与 PyTorch 2.9+ 预览版。
- 🎨 现代 UI：采用深色磨砂玻璃（Glassmorphism）视觉风格，支持响应式布局。
- 📦 零门槛部署：内置 Python 原生虚拟环境 (venv) 自动构建脚本，无需手动安装依赖。
- 🌐 国内加速：默认集成 Hugging Face 镜像站逻辑，支持 10GB-32GB 模型文件的断点续传。
- 🛠️ 智能硬件感应：自动检测 GPU 型号并分流安装最匹配的驱动与推理引擎。

## 📂 项目结构

```Plaintext
z-turbo-ui/
├── 1-安装环境与模型.bat      # 首次运行使用：创建环境 + 下载模型
├── 2-启动服务.bat            # 日常使用：一键开启后端与网页
├── install_all.py            # 环境与模型管理核心逻辑
├── backend/
│   ├── main.py               # FastAPI 后端推理服务
│   └── run_app.py            # 启动控制中心
├── frontend/
│   ├── index.html            # UI 界面
│   ├── style.css             # 磨砂风格与滚动条美化
│   └── script.js             # 预设提示词与交互逻辑
├── models/                   # 自动存放下载的模型文件
└── venv/                     # 自动生成的 Python 虚拟环境
```

## 🚀 快速开始

### 前提条件

- 操作系统：Windows 10/11
- Python：已安装 Python 3.10 或更高版本（官网下载）
- 硬件：推荐 NVIDIA GPU（RTX 30/40/50 系列）

### 部署步骤

1. 克隆/下载本项目到本地文件夹。
2. 双击运行 `1-安装环境与模型.bat`：
   - 脚本会自动创建 `venv` 虚拟环境。
   - 自动识别您的显卡并安装对应的 PyTorch（RTX 50 系将安装 cu128 版）。
   - 自动从镜像站下载约 32GB 的模型文件。
3. 双击运行 `2-启动服务.bat`：
   - 等待控制台显示 ✅ 服务已就绪 。
   - 浏览器将自动弹出创作界面。