harry7557558/spirula-studio

▲ 66 stars today★ 585⑂ 47

Cross-vendor 3D Gaussian Splatting trainer - video to splat to mesh, Vulkan or CUDA.

About harry7557558/spirula-studio

harry7557558/spirula-studio is an open-source project on GitHub, mainly written in C++. Cross-vendor 3D Gaussian Splatting trainer - video to splat to mesh, Vulkan or CUDA. It currently holds 585 stars and 47 forks with 35 open issues, and was last pushed on 2026-09-22 (repository created 2024-05-04).

Project Overview

Git Homed tracks it on the Today's Trending board, currently at rank #57 with 66 new stars today.

GitHub Repository Details

Repository harry7557558/spirula-studio · default branch master · size 41380 KB · watchers 19 · source: GitHub REST API and repository README

README

Spirula Studio

GPLv3 License  GitHub Releases  Platform

DownloadBuild from SourceGalleryWeb Viewer

Spirula Studio trains 3D Gaussian Splatting models – from raw photo/video to splat to textured mesh – in one self-contained binary. No Python/PyTorch, no separate COLMAP install. Runs on NVIDIA, AMD, Intel, and Apple GPUs via Vulkan, trains 10M full-SH Gaussians in 8 GB VRAM, and has native support for fisheye and 360° cameras.

Spirula Studio - Open Source 3D Gaussian Splatting Pipeline

Dataset credit: Garage by Simon Bethke (CC BY-SA 4.0); Flight Systems and Control Lab at UTIAS; MegaDepth-X; Mip-NeRF 360.

Features

News

Download

Binaries for Windows, Linux, and macOS can be downloaded from Releases page. Simply select the one for your platform, download and unzip, and double click to open the GUI.

If you are training on remote/cloud GPUs, you may use the CLI – Run spirula --help for details. By default, spirula train command will serve a viewer on an HTTP port, one you can forward over ssh and view training progress in your web browser.

Build from source

To build from source, Spirula Studio provides two backends:

Both provide the same training and meshing functionality. CUDA backend may be faster or slower than Vulkan depending on GPU driver, with difference generally within a few percents. Vulkan backend can be slightly more VRAM efficient in some cases.

| Backend | GPU/Vendor Support | Platform Support | Dependencies | Additional Features | |--------|--------|--------|--------|--------| | Vulkan | NVIDIA, AMD, Intel, Apple Silicon | Windows, Linux, macOS | Vulkan/MoltenVK, CMake/Ninja | Native support for SfM, frame extraction from videos, and AI masking | | CUDA | Most NVIDIA GPUs | Windows, Linux | CUDA, CMake/Ninja | - |

Details for building the Vulkan backend


Make sure you have Vulkan SDK installed. On macOS, MoltenVK is automatically fetched by CMake. Clone the repository and run the commands:

Windows with MSVC:

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

If it builds successfully, you get build_vulkan\spirula.exe.

Windows with 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

Pass -DCMAKE_C_COMPILER and -DCMAKE_CXX_COMPILER to the first cmake command if needed.

If it builds successfully, you get build_vulkan\spirula.exe.

Linux:

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

If it builds successfully, you get build_vulkan/spirula binary.

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 has only the one backend, so it builds into build/ rather than into a per-backend tree. If it builds successfully, you get build/spirula binary similar to Linux. Additionally, it wraps that binary in a double-clickable build/Spirula Studio.app, as well as disk image build/Spirula Studio.dmg. MoltenVK is statically linked by default and will run on a Mac without dependency installed.

Notes regarding third-party licensing

-DSS_ENABLE_PATENTED=ON enables decoding video on the GPU instead of shelling out to ffmpeg (about 15x faster frame extraction, and without need to install ffmpeg). However, AVC/HEVC bitstream parsers carry third-party patent exposure. If you turn this on, you are responsible for ensuring compliance with local patent laws regarding AVC/HEVC playback.

Masking needs a SAM checkpoint, which the GUI downloads on first use and caches. The checkpoints are Meta's models under Meta's licenses – SAM 2.1 is Apache-2.0, SAM 3 is under Meta's own, non-standard license. They are never bundled, and the GUI shows the terms before fetching anything. On the command line, point --model at a file you downloaded yourself.

Details for building the CUDA backend


Make sure you have a recent version of CUDA installed. On Windows, you also need MSVC compiler compatible with your CUDA version. Clone the repository and run the commands:

Windows:

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

If it builds successfully, you get build_cuda\spirula.exe.

Linux:

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

If it builds successfully, you get build_cuda/spirula binary.

Gallery

You can find some professional-quality splats trained by Spirula Studio from Megascapes Library and their SuperSplat page.

Collection of splats created by the users of Spirula Studio can also be found on SuperSplat page.

Some splats created by the author of Spirula Studio can also be found on my SuperSplat page.

Trivia

Spirula Studio (formerly spirulae-splat) is named after the now-inactive project spirulae, which was named after the deep-ocean cephalopod mollusk.

Spirula Studio is developed and maintained almost entirely by one person. Issues and PRs welcome – I sometimes respond late, but rest assured that I do review them all.

GitHub Stars & Activity

585Stars
47Forks
35Open issues
C++Language

GitHub Popularity

GitHub stars585
Forks47
Open issues35
Primary languageC++
LicenseGPL-3.0
Stars gained today66
Created2024-05-04
Last pushed2026-09-22

Trending History

Daily boardrank #57 · ▲ 66 stars

Related GitHub Projects

1

amnezia-vpn / amnezia-client

C++★ 15,131⑂ 1,158▲ 35 stars
2

leejet / stable-diffusion.cpp

C++★ 7,099⑂ 800▲ 29 stars
3

Codensity30 / Strivers-A2Z-DSA-Sheet

C++★ 898⑂ 304▲ 30 stars
4

obra / superpowers

Shell★ 290,158⑂ 25,961▲ 526 stars
5

mattpocock / skills

Shell★ 267,759⑂ 22,588▲ 706 stars
6

affaan-m / ECC

JavaScript★ 265,309⑂ 39,634▲ 805 stars
7

ossu / computer-science

HTML★ 209,372⑂ 25,901▲ 63 stars
8

jackfrued / Python-100-Days

Jupyter Notebook★ 186,784⑂ 55,759▲ 52 stars

More Trending Repositories