Neeshck-Z-lmage_LYX_v2 本地 AI 绘画工具搭建指南
本教程指导用户通过三步完成 Neeshck-Z-lmage_LYX_v2 本地 AI 绘画工具的部署。该工具基于 Z-Image 模型,具有轻量、快速的特点,无需联网即可在本地生成图像。
1. 环境准备
1.1 系统要求
确保电脑满足以下基本要求:
- 操作系统:Windows 10/11,或者 macOS、Linux。
- Python 版本:3.8 到 3.10 之间。
- 显卡(GPU):建议 NVIDIA 独立显卡(显存 4GB 或以上)。无独立显卡可用 CPU 运行,但速度较慢。
- 硬盘空间:至少预留 10GB 可用空间。
1.2 安装依赖
打开命令窗口(Windows)或终端(macOS/Linux),执行以下命令安装 Python 依赖库:
pip install -r requirements.txt
若网络较慢,可添加国内镜像源:
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
下载工具源代码至 Z-Image-LYX 文件夹:
git clone https://github.com/neeshck/Z-Image-LYX.git
cd Z-Image-LYX
确保已安装 Git 工具。如未安装,请前往官网下载或使用包管理器(如 brew install git 或 sudo apt install git)。
2. 模型准备
2.1 下载底座模型
工具核心为 Z-Image 模型。需下载模型文件并放置到指定目录。
- 访问模型仓库(如 Hugging Face)。
- 下载
model.safetensors和config.json文件。 - 创建模型目录并移动文件:
mkdir -p models/Z-Image
cp model.safetensors config.json models/Z-Image/
注意:模型文件较大,请确保下载完整且路径正确。
2.2 添加 LoRA 风格滤镜(可选)
LoRA 文件用于调整生成风格,格式通常为 .safetensors。
- 从社区获取 LoRA 文件。
- 将文件放入
loras文件夹:
mv *.safetensors loras/
启动工具后,系统会自动扫描并列出可用的 LoRA 文件。
3. 启动与使用
3.1 启动工具
确保当前目录为 Z-Image-LYX,运行以下命令:
streamlit run app.py

