Getting Started

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

take a look at the basic tutorial or the tutorial for robotics: Vuer Basics
or try to take a look at the example gallery here

You can install vuer with pip:

shell

pip install -U 'vuer==0.1.6'

Vuer can run directly in the web browser via PyScript and Pyodide. Server dependencies (websockets, aiohttp) are auto-excluded on Emscripten:

python

import micropip
await micropip.install("vuer")

from vuer.schemas import Scene, Box, Urdf

Now you should be able to run scripts show in the examples, and look at the results on vuer.ai.

To view the scene in VR or AR headsets, you need to install ngrok (see setting up ngrok) to promote the websocket to wss.

Using ngrok to promote to wss://

You need to install ngrok to promote the local vuer server from ws://localhost:8012 to wss://xxxx.ngrok.io, (note the double w[ss] in the protocol), and pass it as a query parameter that looks like this:

  https://vuer.ai?ws=wss://xxxxx.ngrok.io

Note the repeated ws and then wss:// in the query string.

Running The Example Gallery

To run the examples, you'll need to download the required assets:

git clone https://github.com/vuer-ai/vuer.git
Download vuer_doc_assets from this Google Drive link
Unzip the downloaded file
Place the vuer_doc_assets folder alongside the project directory and rename it to assets.

parent_directory/
├── vuer/                 # This project
│   ├── docs/
│   ├── vuer/
│   └── README.md
└── assets/      # Downloaded assets folder

Run the examples:

bash

cd docs/examples/meshes
python mesh_loading.py

Note: you need to install a few optional dependencies such as open3d and trimesh for loading and processing point cloud and mesh data. The core vuer itself does not depend on these libraries.

Developing Vuer (Optional)

If you want to develop vuer, you can install it in editable mode plus dependencies relevant for building the documentations:

Using uv (recommended):

shell

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

Using pip:

shell

cd vuer
pip install -e '.[dev]'

To build the documentation:

shell

make clean         # clean the cache from previous building
make docs          # Build HTML documentation
make preview       # Live preview with auto-reload

For more information on contributing, see CONTRIBUTING.md.