whatisgithub

What is bicmap?

open-x-humanoid/bicmap — explained in plain English

Analysis updated 2026-05-18

★ 38JavaScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A WebGL map rendering library for robotics that combines indoor SLAM maps, outdoor tiles, point clouds, and 3D robot models in one scene.

Mindmap

mindmap
  root((BicMap))
    What it does
      Renders indoor and outdoor robot maps together
      Combines SLAM maps point clouds and 3D models
      Wraps MapLibre Three.js and Turf
    Tech stack
      JavaScript
      MapLibre GL
      Three.js
      Vue 3
    Use cases
      Build a robot navigation dashboard
      Show live robot position on a map
      Draw and edit map zones interactively
    Audience
      Robotics developers
      Frontend engineers
    Ecosystem
      BICMap-Mobile uni-app port
      BICMap-Python bridge
      30 plus example scenes

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

Build a combined indoor and outdoor map view for a robot navigation dashboard.

USE CASE 2

Show a robot's live position, path plan, and replayed route on a rendered map.

USE CASE 3

Overlay point clouds and 3D robot models on top of SLAM or tile based maps.

USE CASE 4

Let users draw and edit rectangles, polygons, or circles on a map for zone configuration.

What is it built with?

JavaScriptMapLibre GLThree.jsVue 3Turf.js

How does it compare?

open-x-humanoid/bicmapliominsb/antigravity-chinese-localizationprathamreet/feathermd
Stars383838
LanguageJavaScriptJavaScriptJavaScript
Setup difficultymoderatemoderateeasy
Complexity3/53/52/5
Audiencedevelopergeneraldeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs a package manager install and basic familiarity with MapLibre or Three.js concepts to configure map layers.

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

So what is it?

BicMap is a WebGL based map rendering library built for robotics applications, published as the npm package @x-humanoid-cloud/bic-map. It wraps MapLibre GL, Three.js, and Turf.js into a single tool aimed at showing indoor and outdoor maps in one combined scene, rather than being a general purpose mapping library on its own. The library takes robot related data such as GeoJSON shapes, point clouds, and robot position information, and turns them into layers and overlays that can be combined on a map. Through one shared bicMap object, a developer can render indoor SLAM grid maps, outdoor tile maps, high precision maps, both 2D and 3D point clouds, and 3D robot models together in the same scene, without handling the loading, coordinate conversion, or resource setup for each rendering engine separately. Built in features include direction markers, batches of points of interest, robot position markers, and shapes like rectangles, polygons, circles, and lines. It also supports interactive drawing and editing of these shapes, along with robot specific capabilities such as following a robot's live position, relocating it, real time positioning, path planning, and replaying a recorded route. Its main dependencies, including maplibre-gl, three.js, turf, and a URDF robot model loader, are bundled through npm so there is little extra setup required, and needed CSS and fonts are injected automatically at runtime. The package can be installed through a package manager and used as a plain JavaScript module or as a Vue 3 plugin, or loaded directly through a script tag for environments without a build step. The repository ships an example portal with more than 30 interactive demos covering indoor, outdoor, and robot guided tour scenes. Two related projects extend it further: a mobile app built on uni-app, and a Python wrapper that lets Python code call the same JavaScript SDK through a desktop container. The project is released under the MIT license and is maintained by the Beijing Innovation Center of Humanoid Robotics.

Copy-paste prompts

Prompt 1
Show me how to install @x-humanoid-cloud/bic-map and render a basic indoor SLAM map.
Prompt 2
Explain how to use BicMap as a Vue 3 plugin and access it through this.$bicMap.
Prompt 3
Walk me through adding live robot position tracking and path replay to a BicMap scene.
Prompt 4
Compare BICMap-Mobile and BICMap-Python and tell me which fits a Python desktop app.

Frequently asked questions

What is bicmap?

A WebGL map rendering library for robotics that combines indoor SLAM maps, outdoor tiles, point clouds, and 3D robot models in one scene.

What language is bicmap written in?

Mainly JavaScript. The stack also includes JavaScript, MapLibre GL, Three.js.

What license does bicmap use?

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

How hard is bicmap to set up?

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

Who is bicmap for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

What are similar repos?