SPIRAN ART SUMMONER部署教程：Windows WSL2环境下Streamlit幻光界面运行指南

SPIRAN ART SUMMONER部署教程：Windows WSL2环境下Streamlit幻光界面运行指南

1. 环境准备与系统要求

在开始部署SPIRAN ART SUMMONER之前，请确保您的Windows系统满足以下要求：

• 操作系统：Windows 10 2004及以上版本(推荐Windows 11)
• WSL2：已启用并配置Ubuntu 20.04/22.04发行版
• 显卡：NVIDIA RTX 3060及以上(8GB显存以上为佳)
• 驱动：最新版NVIDIA驱动(建议535版本以上)
• 内存：16GB及以上
• 存储空间：至少30GB可用空间

1.1 检查WSL2状态

打开PowerShell(管理员权限)，运行以下命令检查WSL状态：

wsl --list --verbose

如果显示WSL版本为1，请使用以下命令升级：

wsl --set-version Ubuntu 2

2. 基础环境配置

2.1 安装CUDA Toolkit

在WSL2的Ubuntu终端中执行：

wget https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/cuda-wsl-ubuntu.pin sudo mv cuda-wsl-ubuntu.pin /etc/apt/preferences.d/cuda-repository-pin-600 sudo apt-key adv --fetch-keys https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/3bf863cc.pub sudo add-apt-repository "deb https://developer.download.nvidia.com/compute/cuda/repos/wsl-ubuntu/x86_64/ /" sudo apt-get update sudo apt-get -y install cuda

2.2 安装Python环境

sudo apt update sudo apt install python3-pip python3-venv python3 -m pip install --upgrade pip

3. SPIRAN ART SUMMONER部署步骤

3.1 克隆项目仓库

git clone https://github.com/spiran-art/summoner.git cd summoner

3.2 创建Python虚拟环境

python3 -m venv spira_env source spira_env/bin/activate

3.3 安装依赖包

pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118 pip install -r requirements.txt

3.4 下载模型权重

wget https://spiran-models.oss-cn-hongkong.aliyuncs.com/flux1.safetensors -O models/flux1.safetensors wget https://spiran-models.oss-cn-hongkong.aliyuncs.com/ffx_lora.safetensors -O models/ffx_lora.safetensors

4. 运行幻光界面

4.1 启动Streamlit应用

streamlit run app.py --server.port 8501 --server.address 0.0.0.0

4.2 访问Web界面

在Windows主机浏览器中访问：

http://localhost:8501

5. 使用指南

5.1 基本操作流程

1. 输入祈祷词：在中央文本框中描述您想要的画面
2. 调整参数：
   • 同步率：控制LoRA风格强度(推荐0.7-0.9)
   • 步数：影响细节质量(推荐25-35步)
   • CFG值：控制创意自由度(推荐7-9)
3. **点击"唤醒祈之子"**开始生成
4. 保存作品：右键点击生成图片选择保存

5.2 高级技巧

• 风格提示词：使用"ffx style"、"pyreflies"等关键词增强风格
• 负面提示：添加"blurry, low quality"等减少不良效果
• 批量生成：修改batch_count参数可一次生成多张

6. 常见问题解决

6.1 CUDA内存不足

如果遇到显存不足错误，尝试以下方法：

# 修改app.py中的配置 torch.backends.cuda.matmul.allow_tf32 = True torch.backends.cudnn.allow_tf32 = True

6.2 生成速度慢

可尝试降低分辨率或减少步数：

# 修改config.json { "width": 768, "height": 512, "steps": 28 }

6.3 界面无法访问

检查防火墙设置并确保端口开放：

netsh advfirewall firewall add rule name="Spiran Port" dir=in action=allow protocol=TCP localport=8501

7. 总结

通过本教程，您已经成功在Windows WSL2环境下部署了SPIRAN ART SUMMONER图像生成系统。这套融合了Flux.1-Dev模型与《最终幻想10》美学风格的工具，能够帮助您创造出极具幻光特色的数字艺术作品。

建议初次使用时：

1. 从默认参数开始尝试
2. 逐步调整同步率和步数
3. 多尝试不同的风格提示词组合
4. 保存优秀作品的生成参数

随着使用熟练度提升，您将能够更精准地控制生成效果，创造出独一无二的斯皮拉幻光艺术作品。

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。