intel/scenescape-mapping repository overview

⁠Scenescape's Mapping Service

The Mapping Service generates 3D scene reconstructions — meshes, point clouds, and camera parameters (poses and intrinsics) — from a set of captured images or video frames. It exposes a REST API so other microservices can request reconstructions on demand.

⁠Overview

⁠Features include:

• REST API with JSON responses
• Build-Time Model Selection: Single model per container, no dependency conflicts
• Flexible Input: Multiple images, video files, or both in a single request
• Multiple Output Formats: GLB meshes or point clouds
• Camera Data: Extracts camera poses and intrinsics alongside geometry
• Image Enhancement: Automatic CLAHE preprocessing for improved contrast

⁠Each container is built with one of two state-of-the-art models:

• MapAnything: Universal Feed-Forward Metric 3D Reconstruction
• VGGT: Visual Geometry Grounded Transformer for sparse view reconstruction

Different variants can be chosen by adding a suffix -mapanything or -vggt to the docker tag. The default model is MapAnything.

⁠Documentation

• Getting Started

  • Get Started⁠: A high-level introduction.

• Deployment

  • How to Build from Source⁠: Step-by-step guide to building from source.

• API Reference

  • API Reference⁠: Comprehensive reference for the request/response and event-based communication endpoints.

⁠Community

To report a bug, file a documentation issue, or submit a feature request, please open a GitHub issue⁠.

⁠Contributing

We welcome contributions! Check out our Contributing Guide⁠ to get started.

⁠Supported versions

• 2026.2.0

⁠License

Scenescape repository is licensed under APACHE 2.0 LICENSE⁠.

⁠Sources and Third Party Notices

This distribution includes components licensed under copyleft licenses. The complete corresponding source code for these components is provided in a separate Sources Docker image available on DockerHub intel/scenescape-sources⁠.

See third-party-programs.txt file in the Scenescape Sources Docker image for details on included components and licenses.

⁠Disclaimers

This container image is intended for demo purposes only and not intended for production use. To receive expanded security maintenance from Canonical on the Ubuntu base layer, you may follow the how-to guide to enable Ubuntu Pro in a Dockerfile⁠ which will require the image to be rebuilt.

Depending on your deployment, Scenescape may utilize FFmpeg and/or GStreamer.

FFmpeg is an open source project licensed under LGPL and GPL. See FFmpeg License and Legal Considerations⁠. You are solely responsible for determining if your use of FFmpeg requires any additional licenses. Intel is not responsible for obtaining any such licenses, nor liable for any licensing fees due, in connection with your use of FFmpeg.

GStreamer is an open source framework licensed under LGPL. See Licensing your applications and plugins for use with GStreamer⁠. You are solely responsible for determining if your use of GStreamer requires any additional licenses. Intel is not responsible for obtaining any such licenses, nor liable for any licensing fees due, in connection with your use of GStreamer.