Spirula Studio 安装教程三步在 Windows、Linux 与 macOS 上跑通 3DGS 训练【免费下载链接】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 是一个开源的 3D 高斯泼溅3D Gaussian Splatting训练工具Python、PyTorch、COLMAP 这些统统不用装输入素材 → splat 模型 → 带纹理网格整条链路被塞进一个自包含的二进制里。因此 Spirula Studio 安装这件事相当轻整篇教程其实只回答两个问题你要现成包还是自己编你的显卡是 NVIDIA 还是别的先拿现成包三步启动最省事的路线三步进 Releases 发布页按你的系统Windows / Linux / macOS取对应安装包解压双击启动 GUI选数据集开训。完事。如果你在用一台不带显示器的机器比如远程服务器同一套二进制也带命令行模式怎么部署看下面无头与远程那一节。源码路线一Vulkan 还是 CUDA先选计算后端现成包对不上你的环境或者想开关某些功能时走源码构建。动手前先回答后端问题。**Vulkan推荐**是跨厂商路线NVIDIA 与 AMD也包括 Intel 和 Apple 的显卡都能跑且是 macOS 上唯一的选择。它的构建更快、二进制更小SfM 重建、视频抽帧和 AI 分割也一并打包在内不必另配外部工具。Windows 和 Linux 上要先装 Vulkan SDKmacOS 可以跳过这一步——CMake 会自动获取 MoltenVK 并做静态链接编出的二进制拷到任何一台 Mac 都能直接跑。CUDA则是 NVIDIA 专属的传统路线需要装 CUDA 工具包Windows 与 Linux 支持macOS 不支持。两者在训练与网格化上的功能完全一致速度差距通常只有几个百分点按机器里插的什么卡选就行。后端定了之后三个平台的依赖大同小异列给你编译器Windows 用 Visual Studio 2022含 C 工具集或 GCC/ClangLinux 用 gcc/gmacOS 用 Xcode 命令行工具CMake NinjaVS 里一般自带脚本会自己找Linux 与 macOS 需要自行安装Vulkan SDKVulkan 后端在 Windows 与 Linux 上必备macOS 不需要CUDA 工具包仅 CUDA 后端要macOS 不支持python3可选。缺失时代码生成步骤会被跳过生成文件已随仓库提交没有 python3 照样能构建。源码路线二三个平台的构建命令克隆一次代码即可git clone https://gitcode.com/GitHub_Trending/sp/spirula-studio cd spirula-studioWindowsMSVC在cmd或开发者命令提示符里执行.\build_develop.bat -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功的产物是build_vulkan\spirula.exe。想走 CUDA 后端把命令里的-DSS_BACKENDvulkan换成-DSS_BACKENDcuda最终产物变为build_cuda\spirula.exe。两个细节脚本会自己通过 vswhere 找到 VS 并调用 vcvars64CMake/Ninja 不在 PATH 时则回退到 VS 自带的版本。另外别自己带-B——构建目录由脚本按后端名取改了对不上。Linuxbash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功产物为build_vulkan/spirula。无显示器的服务器加-DSS_BUILD_GUIOFF只出命令行工具——产物不依赖显卡驱动里的图形库也不会拉取任何 GUI 依赖。macOSApple Siliconbash 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之外还会打包出可双击的Spirula Studio.app和.dmg磁盘映像。Spirula Studio 无头部署与远程 GPU 训练 两种很常见的用法放在一起说远程 GPU 服务器在服务器上跑spirula train它默认会在一个 HTTP 端口上提供 3D 预览页面本地用ssh -L转发端口后浏览器里就能看到训练进度——服务器本身不必装图形环境纯无头构建构建阶段加-DSS_BUILD_GUIOFF产物只有命令行工具更轻、依赖更少。关键开关-DSS_ENABLE_PATENTEDON 到底做什么 上面每条命令都带了-DSS_ENABLE_PATENTEDON。它开启进程内 GPU 视频解码启用后抽帧速度快约 15 倍系统侧也不需要调用 ffmpeg不启用时抽帧会回退到系统的 ffmpeg。为什么这个开关默认关着因为涉及 H.264 / H.265 / AV1 编解码解析逻辑存在第三方专利授权问题是否开启请自行确认所在地区的合规要求。原理细节见 docs/build.md。Spirula Studio 安装验证跑这两条命令确认构建或安装完成后打开终端执行spirula --version spirula --helpWindows 下对应spirula.exe --version与spirula.exe --help。两条命令都能正常应答说明安装完成。再直接敲spirula而不带任何参数它会直接进入图形界面左侧是数据集选择与训练参数面板中间是 3D 预览区看到它们就稳了。Spirula Studio 构建报错速查你大概率会碰上的几个问题 Windows 报vcvars64.bat not found说明 VS 里没装 C 桌面开发的工作负载。在 VS 中补装它或者直接改用开发者命令提示符运行构建脚本会自动探测 VS 的安装位置。Vulkan 后端 CMake 配置失败原因多数是同一个Vulkan SDK 没就位。在 Windows 或 Linux 上装好它再重新配置macOS 则无需任何 SDK。断网时 GUI 构建失败GUI 首次构建需要联网下载 GLFW 与 Dear ImGui一次性。完全离线的环境加-DSS_BUILD_GUIOFF绕过即可。并行编译被 OOM 杀掉不用自己加-j。构建脚本启动前会估算可用内存并换算出并发数按约 750MB/任务计不会超出机器承受能力。macOS 上网格化只跑单核OpenMP 没被找到。先brew install libomp——它是 keg-only 的CMake 默认找不到而构建脚本会自动探测到该库的所在位置并传给 CMake。nvcc 编译报错CUDA 版本与编译器不匹配。脚本默认挑机器里装的最新版 CUDA不是你想要的那一个时传-DCMAKE_CUDA_COMPILER...指定别家版本。中文路径显示为方块全量 CJK 字体还没下载。首次用到中文时 GUI 会提示你下载并缓存属正常行为。装完之后丢素材进去就能训练到这一步把照片或视频放进数据集目录即可——内置 SfM 会先做完重建再直接开训任何外部工具都不必再装。想再深入一点全部构建选项见 cmake/SsOptions.cmake双后端架构设计见 docs/backends.md两个入口脚本是 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），仅供参考