Metadata-Version: 2.4
Name: viser3d
Version: 1.0.20
Summary: 3D visualization + Python
Project-URL: GitHub, https://github.com/nerfstudio-project/viser
License: MIT
License-File: LICENSE
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.8
Requires-Dist: imageio<3.0.0,>=2.0.0
Requires-Dist: msgspec<1.0.0,>=0.18.6
Requires-Dist: nodeenv<2.0.0,>=1.9.1
Requires-Dist: numpy<3.0.0,>=1.0.0
Requires-Dist: requests<3.0.0,>=2.0.0
Requires-Dist: rich<15.0.0,>=13.3.3
Requires-Dist: tqdm<5.0.0,>=4.0.0
Requires-Dist: trimesh<5.0.0,>=3.21.7
Requires-Dist: typing-extensions>=4.0.0
Requires-Dist: websockets<16.0.0,>=13.1
Requires-Dist: yourdfpy<1.0.0,>=0.0.53
Provides-Extra: dev
Requires-Dist: hypothesis[numpy]; extra == 'dev'
Requires-Dist: opencv-python<5.0.0,>=4.0.0.21; extra == 'dev'
Requires-Dist: pre-commit==3.3.2; extra == 'dev'
Requires-Dist: psutil<8.0.0,>=5.9.5; extra == 'dev'
Requires-Dist: pyright>=1.1.308; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: ruff>=0.9.3; extra == 'dev'
Provides-Extra: examples
Requires-Dist: gdown>=4.6.6; extra == 'examples'
Requires-Dist: matplotlib>=3.7.1; extra == 'examples'
Requires-Dist: opencv-python; extra == 'examples'
Requires-Dist: pandas; extra == 'examples'
Requires-Dist: plotly>=5.21.0; extra == 'examples'
Requires-Dist: plyfile; extra == 'examples'
Requires-Dist: pyliblzfse>=0.4.1; (platform_system != 'Windows') and extra == 'examples'
Requires-Dist: robot-descriptions>=1.18.0; extra == 'examples'
Requires-Dist: torch>=1.13.1; extra == 'examples'
Requires-Dist: tyro<1.0.0,>=0.2.0; extra == 'examples'
Description-Content-Type: text/markdown

<h1 align="left">
    <img alt="viser logo" src="https://viser.studio/main/_static/logo.svg" width="30" height="auto" />
    Viser
    <img alt="viser logo" src="https://viser.studio/main/_static/logo.svg" width="30" height="auto" />
</h1>

<p align="left">
    <img alt="pyright" src="https://github.com/nerfstudio-project/viser/actions/workflows/pyright.yml/badge.svg" />
    <img alt="typescript-compile" src="https://github.com/nerfstudio-project/viser/actions/workflows/typescript-compile.yml/badge.svg" />
    <a href="https://pypi.org/project/viser/">
        <img alt="codecov" src="https://img.shields.io/pypi/pyversions/viser" />
    </a>
    <a href="https://discord.gg/pnNTkHNUwP">
        <img alt="Viser Discord"  src="https://img.shields.io/discord/1423204924518432809?logo=discord&label=discord" />
    </a>
</p>

Viser is a 3D visualization library for computer vision and robotics in Python.

Features include:

- API for visualizing 3D primitives.
- GUI building blocks: buttons, checkboxes, text inputs, sliders, etc.
- Scene interaction tools (clicks, selection, transform gizmos).
- Programmatic camera control and rendering.
- An entirely web-based client, for easy use over SSH!

The goal is to provide primitives that are (1) easy for simple visualization tasks, but (2) can be composed into more elaborate interfaces. For more about design goals, see the [technical report](https://arxiv.org/abs/2507.22885).

Examples and documentation: https://viser.studio

## Installation

You can install `viser3d` with `pip`:

```bash
pip install viser3d            # Core dependencies only.
pip install viser3d[examples]  # To include example dependencies.
```

That's it! To learn more, we recommend looking at the examples in the [documentation](https://viser.studio/).

## Citation

To cite Viser in your work, you can use the BibTeX for our [technical report](https://arxiv.org/abs/2507.22885):

```
@misc{yi2025viser,
      title={Viser: Imperative, Web-based 3D Visualization in Python},
      author={Brent Yi and Chung Min Kim and Justin Kerr and Gina Wu and Rebecca Feng and Anthony Zhang and Jonas Kulhanek and Hongsuk Choi and Yi Ma and Matthew Tancik and Angjoo Kanazawa},
      year={2025},
      eprint={2507.22885},
      archivePrefix={arXiv},
      primaryClass={cs.CV},
      url={https://arxiv.org/abs/2507.22885},
}
```

## Acknowledgements

`viser` is heavily inspired by packages like
[Pangolin](https://github.com/stevenlovegrove/Pangolin),
[Dear ImGui](https://github.com/ocornut/imgui),
[rviz](https://wiki.ros.org/rviz/),
[meshcat](https://github.com/rdeits/meshcat), and
[Gradio](https://github.com/gradio-app/gradio).

The web client is implemented using [React](https://react.dev/), with:

- [Vite](https://vitejs.dev/) / [Rollup](https://rollupjs.org/) for bundling
- [three.js](https://threejs.org/) via [react-three-fiber](https://github.com/pmndrs/react-three-fiber) and [drei](https://github.com/pmndrs/drei)
- [Mantine](https://mantine.dev/) for UI components
- [zustand](https://github.com/pmndrs/zustand) for state management
- [vanilla-extract](https://vanilla-extract.style/) for stylesheets

Thanks to the authors of these projects for open-sourcing their work!
