Spirula Studio 3D 高斯泼溅训练单二进制零配置安装Windows / Linux / macOS 全部搞定【免费下载链接】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 高斯泼溅3DGS训练工具把照片或视频变成 splat 与带纹理网格全程只有一个自包含二进制。本文覆盖 Windows、Linux、macOS 三平台上预编译下载与源码构建两条路径。读完你能不依赖任何 Python 环境直接打开训练界面开训。先跑起来3 步跑通预编译的 3D 高斯泼溅二进制新手走这条最快去项目官方 Releases 页面选择对应平台Windows / Linux / macOS的发布包下载并解压双击spirula.exeWindows或运行./spirulaLinux / macOS启动 GUI把照片或视频放进数据集目录点训练如果你在远程 GPU 服务器上训练则不需要图形界面spirula train默认会在一个 HTTP 端口上提供 3D 预览页面ssh 端口转发后本地浏览器就能看到训练进度。启动成功后的样子就是上图的界面数据集选择与训练面板已经就绪。为什么不用折腾环境零依赖设计一览多数 3DGS 工作流要 Python PyTorch 环境再加一套 COLMAPSpirula Studio 反着来零 Python 依赖不装 Python、PyTorch也不装 COLMAP3D 重建用内置的原生 SfM 完成跨厂商 GPU一个 Vulkan 后端覆盖 NVIDIA、AMD、Intel 和 Apple Silicon双后端功能对等Vulkan推荐与 CUDANVIDIA训练和网格化功能一致性能差异通常控制在几个百分点以内一个二进制全包含GUI、命令行、SfM 重建、AI 分割都在spirula里预编译版够用的话看到这里就可以停了下面这一章只给想亲自编译的人。想自己编译先做选择题Vulkan 还是 CUDA想打开自定义编译参数或你的机器上没有对应平台的发布包时才需要源码构建。先做选择题后端适用 GPU平台一句话特点Vulkan推荐NVIDIA / AMD / Intel / Apple SiliconWindows、Linux、macOS跨厂商构建更快、体积更小自带 SfM 视频抽帧 AI 分割CUDANVIDIAWindows、Linux传统方案需 CUDA 工具包功能与 Vulkan 一致性能差异通常在几个百分点以内先拉代码git clone https://gitcode.com/GitHub_Trending/sp/spirula-studio cd spirula-studio WindowsMSVC.\build_develop.bat -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功产物是build_vulkan\spirula.exe。CUDA 后端把参数换成-DSS_BACKENDcuda产物在build_cuda\spirula.exe。两个注意点脚本会用 vswhere 自动探测 Visual Studio 并调用vcvars64.batPATH 上没有 CMake/Ninja 时直接用 VS 自带的那套CUDA 后端默认自动挑选最新安装的 CUDA 工具包想指定版本就传-DCMAKE_CUDA_COMPILER... Linuxbash build_develop.bash -DSS_BACKENDvulkan -DSS_ENABLE_PATENTEDON成功产物是build_vulkan/spirula。无显示器的无头服务器上加-DSS_BUILD_GUIOFF只构建命令行工具。 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外还会打包出可双击的build/Spirula Studio.app和build/Spirula Studio.dmg。MoltenVK 默认静态链接拷到别的 Mac 上也能直接跑。一个影响行为的参数-DSS_ENABLE_PATENTEDON这个参数启用进程内 GPU 视频解码抽帧速度约快 15 倍且无需安装 ffmpeg。参数默认是 OFF关闭时视频抽帧会回退调用系统里的 ffmpeg。H.264 / H.265 / AV1 解析器带有第三方专利授权问题开启前请自行确认所在地区的合规要求。 另外python3 是完全可选的。缺了它脚本只是跳过代码生成——生成的代码文件已随仓库提交构建不受影响。三平台构建依赖差异一张表看完依赖WindowsLinuxmacOS编译器VS 2022C 工具集脚本自动调 vcvars64gcc/gXcode 命令行工具CMake NinjaVS 自带用官方脚本则无需另装必须必须Vulkan SDK必须Vulkan 后端必须Vulkan 后端不需要MoltenVK 由 CMake 自动获取并静态链接CUDA 工具包仅 CUDA 后端需要脚本自动选最新仅 CUDA 后端需要不支持python3可选缺了自动跳过代码生成可选可选libompOpenMP不需要系统自带即可建议用 Homebrew 装脚本会自动探测 keg-only 路径 最容易漏掉的是 macOS 的 libompHomebrew 把它标成 keg-onlyCMake 默认找不到。构建脚本会自动探测这条路径并传给 CMake你只需brew install libomp。装完跑两条命令确认安装成功spirula --version spirula --helpWindows 下命令换成spirula.exe。--version输出版本号源码构建会额外带提交哈希--help列出train、sfm等全部子命令。两者都能正常输出说明安装成功。直接运行不带参数的spirula会启动 GUI——把数据集丢进去就能开训 报错了按这个顺序查先别慌十有八九是下面这几个按顺序对号入座看到的现象大概率原因你该做的Windows 报vcvars64.bat not found没装 VS 的 C 工具集安装 VS 的C 桌面开发工作负载或在开发者命令提示符里运行脚本Vulkan 后端配置失败没装 Vulkan SDKWindows / Linux 先装 Vulkan SDKmacOS 无需安装GUI 构建卡在拉取 GLFW / ImGui首次构建需要联网 FetchContent联网让它一次性下载完依赖或加-DSS_BUILD_GUIOFF构建目录和脚本提示的对不上手动传了-B参数别传-B脚本会按后端自动选build_vulkan/或build_cuda/大规模并行编译被 OOM 杀掉并发太高、内存不够脚本已按可用内存自动限并发每任务约 750MB不用手动传-jmacOS 上网格化跑在单核没找到 OpenMPlibomp用 Homebrew 安装 libomp构建脚本会自动探测 keg-only 路径并传给 CMakenvcc 编译报错CUDA 版本与编译器不匹配脚本默认选最新安装的 CUDA想指定版本传-DCMAKE_CUDA_COMPILER...中文路径 / 界面显示方块CJK 全量字体未下载首次使用中文字体时 GUI 会提示下载并缓存属正常行为装好之后继续深入docs/build.md —— 构建矩阵与全部选项适合想定制构建参数的人docs/backends.md —— CUDA / Vulkan 后端缝的设计适合想搞懂双后端架构的人docs/datasets.md —— 支持的数据集结构适合准备第一份数据集的人cmake/SsOptions.cmake —— 所有 CMake 选项的定义处适合想抠默认值的人build_develop.bash —— 构建入口脚本自动探测 MSVC / CUDA 环境、自动限并发适合想弄清脚本逻辑的人装好之后最快的上手方式是找一组同一场景的照片训一遍看看效果。【免费下载链接】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），仅供参考
