Spirula Studio 安装指南照片变 3D 高斯泼溅两大后端构建避坑一次讲清【免费下载链接】spirula-studioCross-vendor 3D Gaussian Splatting trainer - video to splat to mesh, Vulkan or CUDA.项目地址: https://gitcode.com/GitHub_Trending/sp/spirula-studioSpirula Studio 是一款跨厂商 GPU 的 3D Gaussian Splatting3DGS训练工具单个自包含二进制即可完成视频/照片 → splat → 带纹理网格全流程不依赖 Python、PyTorch 和 COLMAP。这篇 Spirula Studio 安装指南按预编译 3 步装好 / 源码构建一条命令跑通两条路线覆盖 Windows、Linux、macOS 三平台并提前讲清最容易翻车的坑读完能独立完成安装并验证成功。选路径先决定下载还是自己编你的情况推荐路径理由本机出结果、快速上手预编译包解压即用双击开 GUI远程/无头 GPU 服务器预编译包或-DSS_BUILD_GUIOFF构建命令行模式浏览器看进度服务器无需图形界面需要定制选项或完全离线源码构建Vulkan 后端一条命令产物自包含结论很直接能下预编译包就别自己编构建那章只留给有定制需求的人。 预编译包 3 步装好顺手验证打开项目的 Releases 发布页选对应平台Windows / Linux / macOS的发布包下载并解压双击启动 GUI选数据集开训装完立刻验证两个命令都正常输出即成功Windows 下为spirula.exespirula --version # 输出版本号如 2026.10.16 spirula --help # 输出 train / sfm / sam / mesh 等子命令说明在远程 GPU 服务器上用spirula train跑训练即可——它默认在一个 HTTP 端口7007上提供 3D 预览页面ssh 端口转发后在本地浏览器查看远程机器完全不需要图形界面。⚠️ Windows 的预编译二进制动态链接 CRT运行机需要 Visual C Redistributable14.40 及以上。老机器上的旧版本会让进程在启动时就崩溃。源码构建第一步选后端后端适用 GPU平台额外依赖附带能力Vulkan推荐NVIDIA / AMD / Intel / AppleWindows、Linux、macOSVulkan SDKmacOS 免装MoltenVK 由 CMake 自动获取并静态链接内置 SfM、视频抽帧、AI 分割SAMCUDANVIDIAWindows、LinuxCUDA 工具包无训练与网格化功能相同两者训练与网格化功能完全一致性能差异通常在几个百分点以内。推荐选 Vulkan跨厂商、构建更快、体积更小且 SfM 和 AI 分割只在 Vulkan 构建中默认开启。 python3 是可选依赖生成的代码文件已随仓库提交缺 python3 时构建脚本自动跳过代码生成照常编译。各平台依赖差异依赖WindowsLinuxmacOS编译器Visual Studio 2022含 C 工具集gcc/gXcode 命令行工具CMake NinjaVS 自带脚本自动找到需安装brew install cmake ninjaVulkan SDK必须必须不需要OpenMP系统自带系统自带brew install libomp三平台构建命令各跑通一条先克隆仓库git clone https://gitcode.com/GitHub_Trending/sp/spirula-studio cd spirula-studio WindowsMSVC在cmd或开发者命令提示符中执行.\build_develop.bat -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功产物为build_vulkan\spirula.exe。CUDA 后端换成-DSS_BACKENDcuda产物在build_cuda\spirula.exe。 Linuxbash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功产物为build_vulkan/spirula。无头服务器加-DSS_BUILD_GUIOFF只构建命令行工具不需要显示器和图形库。 macOSApple Siliconbrew install cmake ninja libomp bash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON cmake --build build --target macos_app cmake --build build --target macos_dmgmacOS 只有一个后端构建目录是build/而非build_vulkan/。产物除build/spirula外还会打包出可双击的build/Spirula Studio.app和build/Spirula Studio.dmg。MoltenVK 默认静态链接拷到别的 Mac 上也能直接跑。三个平台构建成功后产物都能这样验证./build_vulkan/spirula --version ./build_vulkan/spirula --help⚠️ 关于-DSS_ENABLE_PATENTEDON它启用进程内 GPU 视频解码抽帧约快 15 倍且无需安装 ffmpeg但 H.264/H.265/AV1 解析器存在第三方专利授权问题是否开启请自行确认所在地区的合规要求。不开启时视频抽帧会回退调用系统里的 ffmpeg。最容易翻车的坑一次说清 坑表现怎么办MSVC 环境缺失Windows 报vcvars64.bat not found安装 VS 2022 的C 桌面开发工作负载或用开发者命令提示符脚本会通过 vswhere 自动探测 VS忘装 Vulkan SDKVulkan 后端 CMake 配置失败Windows/Linux 先装 Vulkan SDKmacOS 不需要断网构建 GUIFetchContent 拉取 GLFW/ImGui 失败GUI 首次构建需联网下载依赖一次性离线就加-DSS_BUILD_GUIOFF自己乱传-B构建目录与脚本不一致构建步骤没跑脚本按后端名自动选build_vulkan/或build_cuda/用SS_BACKEND选目录别手动指定并行编译 OOM大规模并行编译进程被系统杀掉脚本已按内存自动限并发约 750MB/任务无需手动-jmacOS 网格化跑单核OpenMP 没找到网格化/UV unwrap 串行brew install libomp构建脚本会自动探测 keg-only 路径传给 CMakeCUDA 版本与编译器不匹配nvcc 编译报错脚本默认选最新安装的 CUDA要指定版本传-DCMAKE_CUDA_COMPILER...中文路径/界面显示方块CJK 全量字体未下载首次使用中文字体时 GUI 会提示下载并缓存属正常行为装完之后能做什么验证命令通过后把照片或视频丢进数据集目录就能开训内置 SfM 自动重建相机位姿无需任何外部工具训练结果可直接网格化成带纹理模型。延伸阅读构建系统全貌与全部 CMake 选项docs/build.mdVulkan/CUDA 双后端架构设计docs/backends.md支持的数据集格式与解析规则docs/datasets.md后端接缝设计与 Vulkan 后端细节src/backend/README.md构建入口脚本含并发限制、依赖日志修复逻辑build_develop.bash【免费下载链接】spirula-studioCross-vendor 3D Gaussian Splatting trainer - video to splat to mesh, Vulkan or CUDA.项目地址: https://gitcode.com/GitHub_Trending/sp/spirula-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考