Metadata-Version: 2.4
Name: vuer
Version: 0.1.2
License: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python
Requires-Python: >=3.8
Requires-Dist: aiohttp-cors; platform_system != 'Emscripten'
Requires-Dist: aiohttp>=3.10.5; platform_system != 'Emscripten'
Requires-Dist: dotvar>=0.1.1
Requires-Dist: killport; platform_system != 'Emscripten'
Requires-Dist: msgpack
Requires-Dist: numpy>=1.21
Requires-Dist: params-proto==3.3.0
Requires-Dist: pillow
Requires-Dist: websockets; platform_system != 'Emscripten'
Provides-Extra: dev
Requires-Dist: aiohttp-cors; extra == 'dev'
Requires-Dist: aiohttp>=3.10.5; extra == 'dev'
Requires-Dist: cmx; extra == 'dev'
Requires-Dist: furo; extra == 'dev'
Requires-Dist: killport; extra == 'dev'
Requires-Dist: myst-parser; extra == 'dev'
Requires-Dist: pylint>=2.13.4; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.1.2; extra == 'dev'
Requires-Dist: roman; extra == 'dev'
Requires-Dist: sphinx-autobuild; extra == 'dev'
Requires-Dist: sphinx-copybutton; extra == 'dev'
Requires-Dist: sphinx>=7.1.2; extra == 'dev'
Requires-Dist: sphinxcontrib-video>=0.4.1; extra == 'dev'
Requires-Dist: tqdm; extra == 'dev'
Requires-Dist: trimesh; extra == 'dev'
Provides-Extra: example
Requires-Dist: aiohttp-cors; extra == 'example'
Requires-Dist: aiohttp>=3.10.5; extra == 'example'
Requires-Dist: cmx; extra == 'example'
Requires-Dist: functional-notations; extra == 'example'
Requires-Dist: killport; extra == 'example'
Requires-Dist: ml-logger; extra == 'example'
Requires-Dist: open3d>=0.18.0; extra == 'example'
Requires-Dist: opencv-python; extra == 'example'
Requires-Dist: trimesh; extra == 'example'
Description-Content-Type: text/markdown

<h2>Vuer: An Event-Driven, Declarative Visualization Toolkit for GenAI and Robotics
<br/>
<img src="https://api.netlify.com/api/v1/badges/2df7f3ba-1a26-4047-b76a-d7401f907bb5/deploy-status" alt="Production">
<a href="https://pypi.org/project/vuer/">
<img src="https://img.shields.io/pypi/v/vuer.svg" alt="pypi">
</a>
<a href="https://docs.vuer.ai">
<img src="https://readthedocs.org/projects/vuer-py/badge/?version=latest">
</a>
</h2>
<p>
<strong><code>pip install vuer</code></strong>
&nbsp;&nbsp;⬝&nbsp;&nbsp;
<a href="https://docs.vuer.ai">docs</a>
&nbsp;&nbsp;⬝&nbsp;&nbsp;
<a href="#development">development</a>
</p>

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.

## Latest Updates

- **2025-11-28**: All documentation examples are now executable with [downloadable assets](https://drive.google.com/file/d/1sx2-UckFTwEpXZwuSWSc4b2f8z0JAF1F/view?usp=sharing).

## Installation

You can install `vuer` with `pip`:

```shell
pip install -U vuer
```

Here is an example that loads a URDF file and displays it in the browser. For more examples, see the
the [examples](https://docs.vuer.ai/en/latest/examples/meshes/mesh_loading.html) page.

```python
from vuer import Vuer
from vuer.schemas import DefaultScene, Urdf, OrbitControls

app = Vuer()

@app.spawn(start=True)
async def main(sess):
    sess.set @ DefaultScene(
        Urdf(src="https://raw.githubusercontent.com/nasa-jpl/m2020-urdf-models/main/rover/m2020.urdf"),
        up=[0, 0, -1],  # Z-down coordinate system
        bgChildren=[OrbitControls(key="OrbitControls")]
    )

    await sess.forever()
```

[![Click for Live Demo](./assets/curiosity.png)](https://vuer.ai?collapseMenu=True&background=131416,fff&initCamPos=2.8,2.2,2.5&ws=ws%3A%2F%2Flocalhost%3A8012&scene=3gAJqGNoaWxkcmVukd4ABKhjaGlsZHJlbpHeAAaoY2hpbGRyZW6Qo3RhZ6RVcmRmo2tleaExo3NyY9lSaHR0cHM6Ly9yYXcuZ2l0aHVidXNlcmNvbnRlbnQuY29tL25hc2EtanBsL20yMDIwLXVyZGYtbW9kZWxzL21haW4vcm92ZXIvbTIwMjAudXJkZqtqb2ludFZhbHVlc94AAKhyb3RhdGlvbpPLQAkeuGAAAAAAAKN0YWenTW92YWJsZaNrZXmhMqhwb3NpdGlvbpMAAMs%2FwzMzQAAAAKN0YWelU2NlbmWja2V5oTOidXCTAAABpGdyaWTDqHNob3dMZXZhwqtyYXdDaGlsZHJlbpLeAASoY2hpbGRyZW6Qo3RhZ6xBbWJpZW50TGlnaHSja2V5tWRlZmF1bHRfYW1iaWVudF9saWdodKlpbnRlbnNpdHkB3gAFqGNoaWxkcmVukKN0YWewRGlyZWN0aW9uYWxMaWdodKNrZXm5ZGVmYXVsdF9kaXJlY3Rpb25hbF9saWdodKlpbnRlbnNpdHkBpmhlbHBlcsOsaHRtbENoaWxkcmVukLJiYWNrZ3JvdW5kQ2hpbGRyZW6Q")

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

- browse the example gallery [here](https://docs.vuer.ai/en/latest/examples/meshes/mesh_loading.html)
- try the demo showing a Unitree Go1 robot in front of a staircase [here](https://docs.vuer.ai/en/latest/examples/urdf_go1_stairs.html)

For more details:

- A full list of visualization components: [API documentation on Components](https://docs.vuer.ai/en/latest/api/vuer.html).

- A full list of data types: [API documentation on Data Types](https://docs.vuer.ai/en/latest/api/types.html).

## Using Vuer with Claude Code

Vuer includes a [Claude Code skill](https://github.com/vuer-ai/vuer-skill) that teaches Claude how to use the library. To install:

```
/plugin marketplace add vuer-ai/vuer-skill
/plugin install vuer@vuer-ai-vuer-skill
```

See the [full guide](https://docs.vuer.ai/en/latest/guides/claude_skill.html) for details.

## Examples

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

1. Download `vuer_doc_assets` from [this Google Drive link](https://drive.google.com/file/d/1sx2-UckFTwEpXZwuSWSc4b2f8z0JAF1F/view?usp=sharing)
2. Unzip the downloaded file
3. 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
```

4. Run the examples:

```bash
cd docs/examples/meshes
python mesh_loading.py
```

## Development

### Setup

**Using uv (recommended):**
```bash
uv sync --group dev
source .venv/bin/activate
```

**Using pip:**
```bash
pip install -e '.[dev]'
```

### Common Tasks

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

### Contributing

We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines on:
- Setting up your development environment
- Code quality standards (ruff formatting and linting)
- Documentation workflow
- Publishing releases

## Running Vuer from the Browser

Vuer can run directly in the web browser via PyScript and Pyodide. To support this, server dependencies (`websockets`, `aiohttp`) are automatically excluded when `platform_system == 'Emscripten'`.

```python
import micropip
await micropip.install("vuer")

from vuer.schemas import Scene, Box, Sphere, Urdf
```

This enables use cases like:
- Building interactive 3D scene editors in the browser
- Running Python-based scene generation in JupyterLite notebooks
- Prototyping robotics visualizations without a local Python server

## To Cite

```bibtex
@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}
}
```

## About Us

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



