Windows 本地部署指南

Windows 本地部署指南#

📖 概述#

本文档将详细指导您在Windows环境下完成LightX2V的本地部署配置，包括批处理文件推理、Gradio Web界面推理等多种使用方式。

🚀 快速开始#

环境要求#

硬件要求#

  • GPU: NVIDIA GPU，建议 8GB+ VRAM

  • 内存: 建议 16GB+ RAM

  • 存储: 强烈建议使用 SSD 固态硬盘，机械硬盘会导致模型加载缓慢

🎯 使用方式#

方式一：使用批处理文件推理#

参考快速开始文档安装环境，并使用批处理文件运行。

方式二：使用Gradio Web界面推理#

手动配置Gradio#

参考快速开始文档安装环境，参考Gradio部署指南

一键启动Gradio（推荐）#

📦 下载软件包

📁 目录结构 解压后，确保目录结构如下：

├── env/                        # LightX2V 环境目录
├── LightX2V/                   # LightX2V 项目目录
├── start_lightx2v.bat          # 一键启动脚本
├── lightx2v_config.txt         # 配置文件
├── LightX2V使用说明.txt         # LightX2V使用说明
├── outputs/                    # 生成的视频保存目录
└── models/                     # 模型存放目录

RTX 50系显卡用户注意：我们提供了专用的运行环境。请从夸克网盘下载，解压后替换软件包中的 env/ 目录即可。

📥 下载模型:

可直接从gradio前端下载，提供了两个下载源，huggingface和modelscope，可根据自己情况选择，或参考模型结构文档手动下载

📋 配置参数

编辑 lightx2v_config.txt 文件，根据需要修改以下参数：

# 界面语言 (zh: 中文, en: 英文)
lang=zh

# 服务器端口
port=8032

# GPU设备ID (0, 1, 2...)
gpu=0

# 模型路径
model_path=models/

🚀 启动服务

双击运行 start_lightx2v.bat 文件，脚本将：

  1. 自动读取配置文件

  2. 验证模型路径和文件完整性

  3. 启动 Gradio Web 界面

  4. 自动打开浏览器访问服务

Gradio中文界面

⚠️ 重要提示:

  • 页面显示问题: 如果网页打开空白或显示异常，请运行 pip install --upgrade gradio 升级Gradio版本。