pip install 'vuer[all]'   ⬝   docs   ⬝   development

Vuer is a light-weight visualization toolkit for interacting with dynamic 3D and robotics data. It is VR and AR ready, and can be run on mobile devices.

You can install vuer with pip:

pip install -U 'vuer[all]'

Here is an example that loads a URDF file and displays it in the browser. For a more comprehensive list of examples, please refer to the examples page.

from vuer import Vuer, VuerSession
from vuer.schemas import DefaultScene, Urdf

app = Vuer()


@app.spawn(start=True)
async def main(session: VuerSession):
    app.set @ DefaultScene(
        Urdf("assets/urdf/robotiq.urdf"),
    )

    while True:
        await session.sleep(0.1)

To get a quick overview of what you can do with vuer, check out the following:

• take a look at the example gallery here
• or try to take a look at this demo with a Unitree Go1 robot in front of a flight of stairs here

For a comprehensive list of visualization components, please refer to the API documentation on Components.

For a comprehensive list of data types, please refer to the API documentation on Data Types.

Now, to run the examples, first download the example datasets.

Each subdirectory in the assets directory contains a Makefile. Run the make command in each subdirectory to download the datasets. For example:

cd assets/static_3d
make

Then run the examples

cd vuer/examples/vuer
python 01_trimesh.py

Using uv (recommended):

uv sync --group dev
source .venv/bin/activate

Using pip:

pip install -e '.[dev]'

make docs     # Build documentation
make preview  # Build and live preview at http://0.0.0.0:8000
make test     # Run tests
make clean         # Clean build artifacts

We welcome contributions! See CONTRIBUTING.md for detailed guidelines on:

• Setting up your development environment
• Code quality standards (ruff formatting and linting)
• Documentation workflow
• Publishing releases

@software{vuer,
  author = {Ge Yang},
  title = {{VUER}: An Event-Driven, Declarative Visualization Toolkit for GenAI and Robotics},
  version = {},
  publisher = {GitHub},
  url = {https://github.com/vuer-ai/vuer},
  year = {2025}
}

Vuer is built by researchers at MIT and UCSD in fields including robotics, computer vision, and computer graphics.