explaingit

donalleniii/lingbot-desktop-mac

Analysis updated 2026-05-18

78PythonAudience · researcherComplexity · 3/5LicenseSetup · moderate

TLDR

A Mac app that turns a dragged-in video into an explorable 3D point cloud, running the Lingbot-Map reconstruction model fully locally on Apple Silicon.

Mindmap

mindmap
  root((repo))
    What it does
      Converts video to 3D point cloud
      Runs fully on-device
      Custom viser-based viewer
    Tech stack
      Python
      FastAPI
      PyTorch
      Apple Silicon MPS
    Use cases
      Explore handheld video as 3D scene
      Export point cloud or splat file
      Research 3D reconstruction locally
    Audience
      Researchers
      Vibe coders

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

What do people build with it?

USE CASE 1

Turn a handheld phone video into an explorable 3D point cloud on your own Mac.

USE CASE 2

Preview streaming 3D reconstruction results without sending video to the cloud.

USE CASE 3

Export the reconstructed scene as a point cloud or splat-format PLY file.

USE CASE 4

Experiment with the Lingbot-Map reconstruction model on Apple Silicon hardware.

What is it built with?

PythonFastAPIPyTorchApple Silicon MPSviser

How does it compare?

donalleniii/lingbot-desktop-maca2328275243/mempalace-evolveanthonykhayesaudsrx50512/flash-usdt-sender
Stars787878
LanguagePythonPythonPython
Setup difficultymoderateeasymoderate
Complexity3/53/53/5
Audienceresearcherdevelopergeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires an Apple Silicon Mac and downloading a roughly 4.6 GB model checkpoint before first use.

The wrapper code is free to use commercially or non-commercially under Apache 2.0, but the separately downloaded model checkpoint has its own, possibly more restrictive, license that must be checked separately.

In plain English

Lingbot-Desktop is a Mac app that turns a video into an explorable 3D scene. You drag a video into the window, wait a few minutes while it processes, and end up with a 3D point cloud you can orbit around, along with the camera path that was solved for the video. Everything runs locally on Apple Silicon chips, with no cloud service and no remote GPU involved. The actual 3D reconstruction is done by a separate research project called Lingbot-Map, built by the Robbyant team, based on a published paper about streaming 3D reconstruction. This project is a Mac wrapper around that work: it provides the drag and drop interface, a FastAPI backend, an installer, and a custom viewer with features like automatic upright alignment, a playback strip, and buttons to save the result as a point cloud or a splat format file. It is important to note the output is a point cloud, not Gaussian splatting, even though a splat format file can be exported. Installation is a single command that downloads and runs an installer script, which asks before installing anything, sets up a Python virtual environment, installs Apple Silicon PyTorch, clones the Lingbot-Map project at a pinned version, and downloads a roughly 4.6 gigabyte model checkpoint from Hugging Face. A more manual, step by step installation path is also documented for anyone who prefers to review each step first. Once installed, a double clickable launch file starts a local server and opens the viewer in a browser window. Performance depends heavily on your Mac's hardware. On the developer's own machine, a high end Apple Silicon MacBook Pro, processing runs at roughly 0.3 to 1.0 frames per second, meaning a short clip takes a few minutes rather than being instant, and the README is upfront that this is not real time and that weaker machines will be slower. It also gives a practical filming tip: moving the camera through a scene works far better than pointing it and rotating in place. The wrapper code itself is released under the Apache 2.0 license, but the downloaded model checkpoint carries its own separate license terms that may be more restrictive, so the README asks users to check those before use.

Copy-paste prompts

Prompt 1
Walk me through installing Lingbot-Desktop on my Mac using the one-line installer script.
Prompt 2
Help me do the manual, step-by-step install of Lingbot-Desktop instead of the automatic script.
Prompt 3
Explain why my reconstruction quality is poor and how camera movement affects it.
Prompt 4
Show me how to verify the downloaded model checkpoint's SHA256 hash before running it.

Frequently asked questions

What is lingbot-desktop-mac?

A Mac app that turns a dragged-in video into an explorable 3D point cloud, running the Lingbot-Map reconstruction model fully locally on Apple Silicon.

What language is lingbot-desktop-mac written in?

Mainly Python. The stack also includes Python, FastAPI, PyTorch.

What license does lingbot-desktop-mac use?

The wrapper code is free to use commercially or non-commercially under Apache 2.0, but the separately downloaded model checkpoint has its own, possibly more restrictive, license that must be checked separately.

How hard is lingbot-desktop-mac to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is lingbot-desktop-mac for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.