gitwtfhub

wtf is free-splatter.cpp?

localai-org/free-splatter.cpp — explained in plain English

Analysis updated 2026-05-18

31C++Audience · developerComplexity · 4/5LicenseSetup · moderate

TL;DR

A CPU friendly C++ tool that turns a handful of photos into a 3D Gaussian splat scene, no camera poses or GPU required.

Mindmap

mindmap
  root((free-splatter.cpp))
    What it does
      Photos to 3D Gaussians
      No camera poses needed
      Runs on CPU or GPU
    Tech stack
      C++
      ggml
      Vulkan
      Go web server
    Use cases
      3D scene reconstruction
      Embed via C API
      Build demo videos
    Audience
      Developers
      Researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Turn a set of photos of an object into a 3D Gaussian splat scene without a GPU or Python.

REASON 2

Embed the free-splatter engine into another application through its plain C API.

REASON 3

Run a browser based demo where dropped photos are reconstructed into a viewable 3D scene.

REASON 4

Benchmark CPU versus GPU reconstruction speed for sparse view 3D reconstruction.

What's in the stack?

C++ggmlVulkanGoCMake

How it stacks up

localai-org/free-splatter.cppadiao1973/librobotbagfixauthrequest/freeloader
Stars313130
LanguageC++C++C++
Setup difficultymoderatehardhard
Complexity4/54/55/5
Audiencedeveloperops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires downloading model weights separately from Hugging Face and a C++17 compiler.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

free-splatter.cpp turns a handful of ordinary photos of an object or scene into a 3D representation called Gaussian splats, without needing camera position information, without needing a GPU, and without needing Python installed. It is a small C and C++ program that runs a neural network called FreeSplatter to do this work, and it can run on a regular computer processor or speed things up on a compatible graphics card. You give the program several photos of the same object or scene, and for every pixel in those photos it produces a small 3D shape called a Gaussian, which includes that point's position, color, transparency, size, and orientation in space. A viewer built for Gaussian splats can then render all of these points together as a 3D scene you can look around in from any angle. According to the README's own benchmarks on one test machine, using a graphics card takes about a fifth of a second to process two photos, which is roughly six times faster than the original Python version of FreeSplatter running on the same graphics card. Even running on the processor alone, with no graphics card at all, it is still about four times faster than the reference Python version. The project includes a command line tool for turning photos into splat files, plus a small web application, built with the Go programming language, that lets you drop photos in a browser and see the reconstruction, and can also stitch several reconstructed scenes together into a demo video. For developers, the core engine is also available as a plain C library, so it can be embedded directly into other software written in different programming languages. Building it requires CMake and a C++ compiler, with an optional Nix based setup that handles these dependencies automatically. Model weights are downloaded separately from Hugging Face. The project and the model weights it uses are both released under the Apache 2.0 license.

Yoink these prompts

Prompt 1
Help me build free-splatter.cpp with CMake and run it on my two test photos to produce a splat file.
Prompt 2
Explain how free-splatter.cpp's C API lets me embed the engine into my own application.
Prompt 3
Show me how to set up the Go web demo for free-splatter.cpp and view a splat in the browser.
Prompt 4
Compare CPU and GPU performance for free-splatter.cpp based on the README's benchmark numbers.

Frequently asked questions

wtf is free-splatter.cpp?

A CPU friendly C++ tool that turns a handful of photos into a 3D Gaussian splat scene, no camera poses or GPU required.

What language is free-splatter.cpp written in?

Mainly C++. The stack also includes C++, ggml, Vulkan.

What license does free-splatter.cpp use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is free-splatter.cpp to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is free-splatter.cpp for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.