image-multiple-angles-3d-camera

环境要求

• Python 环境，可执行 pip 与 python 命令
• NVIDIA GPU（建议 RTX 3090 及以上）
• 显存 16 GB 以上
• 可用磁盘空间 60 GB 以上（模型约 56 GB）
• 稳定的网络或提前下载好模型权重

安装与启动步骤

1. 1确认硬件条件

   本地部署无需联网、无调用费用，但需下载约 56 GB 模型，并要求 NVIDIA GPU 16 GB+ 显存、60 GB+ 可用磁盘。

2. 2安装项目依赖

   先安装 requirements.txt 中的依赖，再补装推理与界面所需的相关库；建议在虚拟环境中执行。

   pip install -r requirements.txt
   pip install gradio diffusers transformers accelerate peft safetensors sentencepiece torchvision

   复制

3. 3改为本地推理

   在 core.py 中把 infer_camera_edit 函数替换为下方本地推理代码，加载基础模型与两个 LoRA 适配器。

   import torch
   from diffusers import QwenImageEditPlusPipeline
   
   dtype = torch.bfloat16
   device = "cuda" if torch.cuda.is_available() else "cpu"
   
   pipe = QwenImageEditPlusPipeline.from_pretrained(
       "Qwen/Qwen-Image-Edit-2511", torch_dtype=dtype
   ).to(device)
   
   pipe.load_lora_weights(
       "lightx2v/Qwen-Image-Edit-2511-Lightning",
       weight_name="Qwen-Image-Edit-2511-Lightning-4steps-V1.0-bf16.safetensors",
       adapter_name="lightning",
   )
   pipe.load_lora_weights(
       "fal/Qwen-Image-Edit-2511-Multiple-Angles-LoRA",
       weight_name="qwen-image-edit-2511-multiple-angles-lora.safetensors",
       adapter_name="angles",
   )
   pipe.set_adapters(["lightning", "angles"], adapter_weights=[1.0, 1.0])

   复制

4. 4启动 Web 应用

   根据需要的界面语言选择中文版或英文版脚本启动，首次运行会下载模型权重，需耐心等待。

   python app_zh.py

   复制

5. 5生成多角度图像

   上传图片后调整相机：绿色手柄控制方位角、粉色手柄控制仰角，距离用下方滑块调节（步长 0.05），点击生成并在固定种子后复现。

关键配置

如何确认成功

终端不再报错并输出 Gradio 的本地访问地址，浏览器打开该地址能看到 3D 相机界面，可上传图片并调整方位角、仰角与距离滑块。

常见问题

注意事项

• README 中快速开始部分仅给出了方式二的本地部署步骤，未展示其他部署方式的具体命令，请以仓库最新文档为准。
• 示例代码使用 Qwen/Qwen-Image-Edit-2511 作为基础模型，并加载 lightning 与 angles 两个 LoRA 适配器，首次运行会触发大体积权重下载。
• 项目处于早期阶段，交互方式直观但功能仍在完善中。
• 基于视角 prompt 的精确角度控制依赖 Qwen-Image-Edit-Plus，更换后端时效果可能下降。