Spirula Studio 安装教程3D Gaussian Splatting 训练器从预编译到源码构建装一遍就懂【免费下载链接】spirula-studioCross-vendor 3D Gaussian Splatting trainer - video to splat to mesh, Vulkan or CUDA.项目地址: https://gitcode.com/GitHub_Trending/sp/spirula-studio装完 Spirula Studio你手上只有一个自包含二进制spirula不带参数运行进图形界面带参数就是 3D Gaussian Splatting 训练器SfM 重建、视频抽帧、AI 分割全内置全程不碰 Python 和 PyTorch也不用单独装 COLMAP。这篇写给第一次装它的新手按先选路线、再分平台动手的顺序把 Windows、Linux、macOS 三条线该装的依赖、该敲的命令、该拿到的产物讲到位。先选型预编译还是源码构建桌面机、装完立刻开训 → 预编译包。机器是远程 GPU 服务器只有 ssh没有显示器→ 预编译包 命令行进度走端口转发看。发布版缺你要的修复或想自己调构建参数比如不开带专利风险的模块→ 源码构建。显卡是 NVIDIA 且想走 CUDA 后端 → 源码构建。快车道预编译包三步装好 打开项目 Releases 发布页按系统挑 Windows / Linux / macOS 的包下载、解压得到可执行程序双击进 GUI或终端里敲spirula --help查看全部子命令。在远程 GPU 服务器上不用装任何图形组件。spirula train会自动开一个 HTTP 端口挂 3D 预览页本地用ssh -L把端口转过来浏览器里即可盯训练进度。构建线源码按平台走先克隆一次下面三个平台共用同一份代码git clone https://gitcode.com/GitHub_Trending/sp/spirula-studio cd spirula-studio后端选一个Vulkan 面向 NVIDIA/AMD/Intel/Apple构建更快、产物更小且自带 SfM、视频抽帧与 AI 分割CUDA 只面向 NVIDIA。功能上两条路线一致。下面按 Vulkan 给命令换 CUDA 只需把-DSS_BACKEND的值改掉构建目录也会相应变成build_cuda/。 Windows 上如何准备环境并构建依赖VS 2022 装C 桌面开发工作负载脚本用 vswhere 定位 VS 并调 vcvars64CMake/Ninja 缺省时回落 VS 自带副本Vulkan SDK走 CUDA 再加 CUDA 工具包。python3 可选缺了就跳过代码生成。命令.\build_develop.bat -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON产物build_vulkan\spirula.exeCUDA 为build_cuda\spirula.exe独有注意构建目录由脚本按后端名决定别自己传-Bexe 动态链接 CRT拷到别的 Windows 机器需装有 Visual C 运行库。 Linux 如何构建无头服务器如何关 GUI依赖gcc/g、CMake NinjaVulkan SDKCUDA 后端另需 CUDA 工具包。python3 可选。命令bash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON产物build_vulkan/spirula独有注意无显示器的服务器加-DSS_BUILD_GUIOFF只编命令行工具不拉取任何图形依赖。 macOS 如何构建并打包 .app依赖Xcode 命令行工具、CMake NinjaVulkan SDK 不用装CMake 自动拉取 MoltenVK建议brew install libomp否则网格化等步骤跑单核。命令bash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON cmake --build build --target macos_app产物build/spirula外加可双击的build/Spirula Studio.app--target macos_dmg再出.dmg独有注意与另两个平台不同macOS 不分后端目录一切落在build/MoltenVK 走静态链接成品拷到另一台 Mac 能直接跑代价是加载不了 validation layers需要时改-DSS_MACOS_VULKANloader。参数小字典参数作用何时需要加-DSS_BACKENDvulkan\|cuda选计算后端缺省为cuda明确选后端时构建目录名跟着它走-DSS_BUILD_GUIOFF不编 GUI只出命令行工具无显示、无图形库依赖无头服务器、纯远程训练-DSS_ENABLE_PATENTEDON编译进程内 H.264/H.265/AV1 解码与 HEIC 支持抽帧约快 15 倍、免 ffmpeg涉及第三方编解码专利默认关闭视频素材多且已确认当地合规要求-DSS_MACOS_VULKANloadermacOS 改链已安装的 Vulkan loader需要加载 validation layers 调试时-DSS_FONT_CJKnone\|sc\|tc\|jp\|kr\|allCJK 全量字体策略默认fetch首次用到 CJK 语言时下载并缓存构建机禁止联网或做离线区域化构建故障排查现象 → 原因 → 处理现象配置阶段提示找不到 vcvars64.bat。原因C 工具集没装。处理给 VS 2022 补上C 桌面开发工作负载或改用开发者命令提示符重跑。现象Vulkan 后端配置失败。原因机器上没有 Vulkan SDK。处理Windows/Linux 先装 SDKmacOS 不受影响MoltenVK 由 CMake 拉取。现象断网构建 GUI 时中断卡在依赖下载。原因GLFW 与 Dear ImGui 首次构建需联网获取。处理放一次联网窗口或-DSS_BUILD_GUIOFF只编 CLI。现象大规模并行编译中途进程被杀。原因内存耗尽。处理不用手动调-j脚本已按可用内存限并发每任务约 750 MB。现象macOS 上网格化等步骤只跑单核。原因Homebrew 的 libomp 是 keg-onlyCMake 找不到 OpenMP。处理brew install libomp即可构建时会自己把 keg-only 的路径喂给 CMake。现象nvcc 报编译器不兼容。原因脚本默认挑最新安装的 CUDA可能与 MSVC 版本错配。处理命令尾部加-DCMAKE_CUDA_COMPILER...指定。现象中文路径或界面显示方块。原因全量 CJK 字体还没下载。处理这是设计内行为首次使用 CJK 语言时 GUI 会提示下载并落缓存。安装自检spirula --version spirula --helpWindows 下写成spirula.exe --version。成功标志版本号带 git 提交号和完整子命令帮助都能打印再不带参数运行spirula弹出 GUI、看到数据集选择与训练面板即装好了。想深挖时看哪里构建矩阵、全部 CMake 选项与各平台备注docs/build.md双后端架构设计docs/backends.md、src/backend/README.md选项定义源头cmake/SsOptions.cmake构建入口脚本build_develop.bash、build_develop.bat顶层构建清单CMakeLists.txt二进制落袋之后把数据集丢进去就能开训其余工具一个都不用装。【免费下载链接】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），仅供参考
