spirula-studio

Spirula Studio

   

下载 • 从源码构建 • 作品展示 • Web 查看器

Spirula Studio 在单个自包含的二进制文件中训练 3D Gaussian Splatting 模型 – 从原始照片/视频到 splat，再到带纹理的网格。无需 Python/PyTorch，也无需单独安装 COLMAP。它通过 Vulkan 在 NVIDIA、AMD、Intel 和 Apple GPU 上运行，可在 8 GB VRAM 中训练 1000 万个 full-SH Gaussian，并原生支持鱼眼与 360° 相机。

数据集来源：Garage，由 Simon Bethke 提供（CC BY-SA 4.0）；UTIAS 飞行系统与控制实验室；MegaDepth-X；Mip-NeRF 360。

功能特性

• 通过 Vulkan compute 实现跨厂商支持 – 可在 NVIDIA、AMD、Intel 和 Apple GPU 上运行

• 单一策略融合 MCMC/IGS+/MRNF 的优势 – 结果更锐利、漂浮物（floaters）更少，从单个物体到大型场景均适用

• 量化训练带来极致的 VRAM 效率 – 在 8GB VRAM 中可容纳最多 1000 万个 SH3 Gaussian

• 原生支持 360° 相机与 equirectangular（等距柱状投影） – 直接加载数据集即可训练，无需去畸变

• 改进的 Bilateral grid（双边网格） 与 PPISP 用于曝光/白平衡校正 – 提升质量，且不会引入意外的偏色或变暗

• 内置极速 SfM、AI 遮罩、视频抽帧 – 无需等待 COLMAP，也无需运行单独的脚本

• 深度/法线、网格化、天空盒、线性色彩……还有更多。

动态

• 2026 年 9 月 23 日：编辑与渲染功能 – 新增针对 3DGS 模型、稀疏重建、网格与遮罩的编辑功能，并支持导出图像和视频渲染结果。

• 2026 年 9 月 10 日：度量尺度 – 数据集创建模块现在会利用常见视频与图像格式中的遥测 metadata，恢复度量尺度与朝向，解决了用户普遍反馈的重建结果过大/过小或倾斜的问题。

• 2026 年 9 月 3 日：支持 LoMa 特征 – SfM 模块现在支持 LoMa，用于在困难数据集上进行特征检测与匹配。

• 2026 年 8 月 14 日：macOS 支持 – 在 macOS/Apple Silicon 上训练的支持已通过验证。现在可以从 Releases 页面 下载该应用。

• 2026 年 8 月 8 日：多语言支持 – 新增多语言支持，GUI 和 CLI 均可使用。支持的语言：English, 日本語, 简体中文, 繁體中文, 한국어, Deutsch, Français, Español, Português, Italiano, Nederlands, Русский, Türkçe。

下载

Windows、Linux 和 macOS 的二进制文件可从 Releases 页面 下载。选择对应平台的版本，下载并解压，双击即可打开 GUI。

如果你在远程/云端 GPU 上训练，可以使用 CLI – 运行 spirula --help 查看详情。默认情况下，spirula train 命令会在某个 HTTP 端口上提供一个 viewer，你可以通过 ssh 转发，并在浏览器中查看训练进度。

从源码构建

要从源码构建，Spirula Studio 提供两种后端：

• Vulkan（推荐）： 跨平台、跨厂商的选项。测试最充分，可在所有主流 GPU 上运行。构建更快，产出的二进制文件更小。

• CUDA： 面向支持 CUDA 的 NVIDIA GPU 的传统选项。

两者提供相同的训练与网格化功能。CUDA 后端可能比 Vulkan 更快或更慢，具体取决于 GPU 驱动，差异通常在几个百分点之内。在某些情况下，Vulkan 后端在 VRAM 使用上略更高效。

后端	GPU/厂商支持	平台支持	依赖	附加功能
Vulkan	NVIDIA, AMD, Intel, Apple Silicon	Windows, Linux, macOS	Vulkan/MoltenVK, CMake/Ninja	原生支持 SfM、视频抽帧与 AI 遮罩
CUDA	大多数 NVIDIA GPU	Windows, Linux	CUDA, CMake/Ninja	-

构建 Vulkan 后端的详细说明

确保已安装 Vulkan SDK。在 macOS 上，CMake 会自动获取 MoltenVK。克隆仓库并运行以下命令：

Windows 与 MSVC：

cd spirula-studio\
.\build_develop.bat -DSS_BACKEND=vulkan -DSS_ENABLE_PATENTED=ON

若构建成功，你会得到 build_vulkan\spirula.exe。

Windows 与 GCC/Clang：

cd spirula-studio\
cmake -G Ninja -B build_vulkan -DCMAKE_BUILD_TYPE=Release -DSS_BACKEND=vulkan -DSS_ENABLE_PATENTED=ON -DCMAKE_MAKE_PROGRAM=Ninja
cmake --build build_vulkan -j

如有需要，可向第一条 cmake 命令传入 -DCMAKE_C_COMPILER 和 -DCMAKE_CXX_COMPILER。

若构建成功，你会得到 build_vulkan\spirula.exe。

Linux：

cd spirula-studio/
bash build_develop.bash -DSS_BACKEND=vulkan -DSS_ENABLE_PATENTED=ON

若构建成功，你会得到 build_vulkan/spirula 二进制文件。

macOS：

cd spirula-studio/
bash build_develop.bash -DSS_BACKEND=vulkan -DSS_ENABLE_PATENTED=ON
cmake --build build --target macos_app
cmake --build build --target macos_dmg

macOS 只有这一种后端，因此会构建到 build/，而非按后端划分的目录树。若构建成功，你会得到与 Linux 类似的 build/spirula 二进制文件。此外，它还会把该二进制文件封装成可双击运行的 build/Spirula Studio.app，以及磁盘映像 build/Spirula Studio.dmg。MoltenVK 默认静态链接，无需在 Mac 上安装依赖即可运行。

关于第三方许可的说明

-DSS_ENABLE_PATENTED=ON 会在 GPU 上解码视频，而不是调用 ffmpeg（抽帧速度约提升 15 倍，且无需安装 ffmpeg）。不过，AVC/HEVC 码流解析器存在第三方专利风险。若开启该选项，你需要自行确保符合当地关于 AVC/HEVC 播放的专利法律。

遮罩功能需要 SAM checkpoint，GUI 会在首次使用时下载并缓存。这些 checkpoint 是 Meta 的模型，遵循 Meta 的许可证 – SAM 2.1 为 Apache-2.0，SAM 3 采用 Meta 自己的非标准许可证。它们绝不会被捆绑分发，GUI 在获取任何内容前都会显示相关条款。在命令行中，请用 --model 指向你自己下载的文件。

构建 CUDA 后端的详细说明

确保已安装较新版本的 CUDA。在 Windows 上，还需要与你的 CUDA 版本兼容的 MSVC 编译器。克隆仓库并运行以下命令：

Windows：

cd spirula-studio\
.\build_develop.bat -DSS_BACKEND=cuda

若构建成功，你会得到 build_cuda\spirula.exe。

Linux：

cd spirula-studio/
bash build_develop.bash -DSS_BACKEND=cuda

若构建成功，你会得到 build_cuda/spirula 二进制文件。

作品展示

你可以在 Megascapes Library 及其 SuperSplat 页面 找到一些由 Spirula Studio 训练的、达到专业水准的 splat。

由 Spirula Studio 用户创建的 splat 合集也可在 SuperSplat 页面 上找到。

Spirula Studio 作者创作的一些 splat 也可在我的 SuperSplat 页面 上找到。

花絮

Spirula Studio（原名 spirulae-splat）得名于如今已停止维护的项目 spirulae，而后者则以深海头足类软体动物命名。

Spirula Studio 几乎完全由一个人开发和维护。欢迎提交 issue 和 PR – 我有时回复较晚，但请放心，每一条我都会认真查看。