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-studioSpirula Studio 是一款开源的跨厂商 3D Gaussian Splatting3DGS训练工具一个自包含二进制把原始照片或视频直接训成 splat还能输出带纹理的网格。无 Python、无 PyTorch、无 COLMAPNVIDIA / AMD / Intel / Apple 显卡都能跑。这篇按本地桌面、远程 GPU 服务器、无头机器三种场景给出安装最短路径翻车点都写在下面。 选型速查预编译包还是源码构建先定路线再动手。两条大路线按你的场景对号入座场景推荐路线需要自备的东西本地桌面开 GUI 训练Releases 预编译包解压即用无装好显卡驱动即可远程 GPU 服务器本地浏览器看进度预编译 Linux 包 SSH 端口转发一台能 SSH 的机器只有 NVIDIA 卡且想用 CUDA源码构建CUDA 后端CUDA 工具包Windows 另需兼容的 MSVC无显示器机器、不装图形栈源码构建Vulkan 后端 SS_BUILD_GUIOFF无图形库依赖构建全程可离线后端的结论很简单Vulkan 是默认选择——跨厂商、构建更快、二进制更小还自带 SfM 重建、视频抽帧和 AI 分割。CUDA 只留给只有 NVIDIA 卡且明确要用 CUDA的场景两者训练与网格化功能完全一致性能差异一般在几个百分点以内。️ 本地桌面GUI 的最短路径下载预编译包多数人走这条到项目 Releases 页面按平台Windows / Linux / macOS选发布包下载并解压双击spirulaWindows 为spirula.exeGUI 打开把照片或视频拖进数据集流程内置 SfM 重建完就能开训全程不用外部工具。从源码构建想自己掌控参数克隆仓库git clone https://gitcode.com/GitHub_Trending/sp/spirula-studio cd spirula-studioWindows普通cmd里直接执行脚本会自己用 vswhere 找到 Visual Studio 并初始化 MSVC 环境.\build_develop.bat -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON产物在build_vulkan\spirula.exe。想用 CUDA 后端就把参数换成-DSS_BACKENDcuda产物落在build_cuda\spirula.exe。Linux / macOS# Linux bash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON # macOS首次先brew install cmake ninja libomp bash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDONLinux 产物为build_vulkan/spirula。macOS 只有一个后端构建目录固定为build/MoltenVK 由 CMake 自动拉取并静态链接二进制拷到别的 Mac 上也能直接跑。想要双击即用的.app和.dmg再执行cmake --build build --target macos_app与cmake --build build --target macos_dmg。依赖就三件事心里有数Vulkan SDKWindows / Linux 必须预装这是配置失败的头号原因macOS 不需要python3可选。缺了只跳过代码生成生成的文件已随仓库提交构建照常-DSS_ENABLE_PATENTEDON启用进程内 GPU 视频解码抽帧约快 15 倍也不必装 ffmpeg。默认是关的——关掉后抽帧会回退调用系统 ffmpeg你得自己先装好。H.264/H.265/AV1 解析器带第三方专利授权问题是否开启请自行确认所在地区合规要求。另外 macOSMoltenVK 没有视频队列即便开了也仍走 ffmpeg此参数在 Mac 上基本无感️ 远程 GPU 服务器终端训、浏览器看服务器上不用纠结 GUI。用spirula train在终端起训练它默认会开一个 HTTP 端口提供 3D 预览页本地浏览器看进度转发只要一条命令ssh -L 7007:localhost:7007 useryour-server端口号以spirula train实际监听为准。train、sfm、sam、mesh这些子命令都收在spirula一个可执行文件里spirula --help可以先看全貌。 无头机器只构建命令行的构建没有显示器、也不打算装图形栈的机器把 GUI 关掉再构建bash build_develop.bash -DSS_BACKENDvulkan -DSS_BUILD_GUIOFFSS_BUILD_GUIOFF时产物只含命令行工具不需要显示器、不需要 GL 库配置阶段也不再拉取 GLFW / ImGui断网机器也能构建。无头服务器上最常见的翻车原因——GUI 依赖下载失败——直接被这条参数消掉。⚠️ 坑位清单装的过程里踩过的Windows 报vcvars64.bat not foundVS 缺 C 工作负载。装C 桌面开发组件或用开发者命令提示符再跑Vulkan 后端配置失败十有八九是没装 Vulkan SDK。先装 SDK 再跑macOS 不适用MoltenVK 自动获取断网机器构建 GUI 失败GLFW / ImGui 首次配置走 FetchContent 下载一次性。没网就加-DSS_BUILD_GUIOFF自己传-B指定构建目录目录会对不上。脚本按后端名自动选build_cuda/或build_vulkan/选树靠SS_BACKEND大规模并行编译被 OOM 杀掉不用自己调-j。构建脚本按可用内存自动限并发约 750MB/任务CUDA 版本与 MSVC 不匹配脚本默认选最新安装的 CUDA 工具包要钉死某个版本传-DCMAKE_CUDA_COMPILER...macOS 网格化 / UV 展开 / 指标跑得慢OpenMP 没找到。Homebrew 的libomp是 keg-only构建脚本会自动探测 keg 路径传给 CMake若仍串行就brew install libomp后重构建中文界面显示方块首次使用中文字体时 GUI 会下载并缓存 CJK 全量字体属于正常的一次性行为✅ 确认安装成功跑这两行spirula --version # Windows 下为 spirula.exe --version spirula --help版本号和帮助信息能正常输出安装就算落地。再无参数直接运行spirulaGUI 会弹出来——看到上图里的数据集选择与训练面板就可以把素材丢进去了。 延伸阅读构建矩阵、全部 CMake 选项与平台细节docs/build.mdVulkan / CUDA 双后端架构设计docs/backends.md、src/backend/README.md全部 CMake 选项定义cmake/SsOptions.cmake构建入口脚本build_develop.bash、build_develop.bat【免费下载链接】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），仅供参考