whatisgithub

What is odyseus-spatial-vlm?

mercuriustech/odyseus-spatial-vlm — explained in plain English

Analysis updated 2026-05-18

70PythonAudience · developerComplexity · 4/5Setup · hard

In one sentence

Odyseus Spatial VLM combines a vision language model with a depth estimation model to turn a single photo into 3D coordinates for objects a user describes in text.

Mindmap

mindmap
  root((Odyseus))
    What it does
      2D to 3D positioning
      VLM object detection
      Depth estimation
      Point cloud viewer
    Tech stack
      Python
      Three.js
      Depth-Anything-3
    Use cases
      Robot spatial awareness
      Autonomous agents
      VLM prototyping
    Requirements
      Linux
      Two server processes
      Hosted demo available

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

Give a robot or autonomous agent spatial awareness by converting a photo and text prompt into real 3D object positions.

USE CASE 2

Prototype a spatial reasoning layer on top of an existing vision language model without training a new model.

USE CASE 3

Visualize objects a VLM identifies in an image as an interactive 3D point cloud in the browser.

What is it built with?

PythonThree.jsDepth-Anything-3

How does it compare?

mercuriustech/odyseus-spatial-vlmhiangx-robotics/metafinenanovisionx/raev2
Stars707070
LanguagePythonPythonPython
Setup difficultyhardhardhard
Complexity4/55/55/5
Audiencedeveloperresearcherresearcher

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Linux, running two separate local server processes, and pulling the Depth-Anything-3 submodule.

No license information is stated in the README.

So what is it?

Odyseus Spatial VLM is an experiment that combines a vision language model with a depth estimation model to give AI a better understanding of 3D space from a single photograph. A vision language model, or VLM, is an AI that can analyze images and answer questions about them, but it typically only understands things in terms of flat 2D screen coordinates: it can say the chair is in the upper left of the image, but not how far away the chair actually is. This project adds monocular depth estimation, meaning figuring out distance using just one camera, to translate the VLM's 2D outputs into real 3D positions. The workflow is simple. You upload an image and type a prompt describing objects you want to locate, for example select the chair near the desk and the closest door. The VLM identifies the 2D pixel locations of those objects. A separate depth model called Depth-Anything-3 then estimates how far each pixel is from the camera. The system combines these two outputs to calculate real 3D coordinates and displays them as an interactive point cloud in the browser, complete with labeled targets and camera orientation guides, rendered using Three.js, a JavaScript library for 3D graphics. This project is aimed at people building physical robots or autonomous agents that need spatial awareness, since it lets an AI reason about where objects actually sit in 3D space rather than just identifying them on a flat image. It currently runs on Linux, requires running two separate server processes locally, and also has a hosted live demo you can try without any setup.

Copy-paste prompts

Prompt 1
Set up Odyseus Spatial VLM on Linux using the setup-vlm.sh and setup.sh scripts and run both server processes.
Prompt 2
Explain how this project combines a VLM's 2D detections with Depth-Anything-3 to produce 3D coordinates.
Prompt 3
Try the hosted demo at app.odyseus.xyz and describe what the 3D point cloud output looks like for a prompt like select the chair near the desk.
Prompt 4
How would I integrate Odyseus Spatial VLM's 3D output into a robot's navigation or object-grasping pipeline?

Frequently asked questions

What is odyseus-spatial-vlm?

Odyseus Spatial VLM combines a vision language model with a depth estimation model to turn a single photo into 3D coordinates for objects a user describes in text.

What language is odyseus-spatial-vlm written in?

Mainly Python. The stack also includes Python, Three.js, Depth-Anything-3.

What license does odyseus-spatial-vlm use?

No license information is stated in the README.

How hard is odyseus-spatial-vlm to set up?

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

Who is odyseus-spatial-vlm for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.