Skip to main content

3D visualization + Python

Project description

tyro logo

pip install viser   •   Documentation

pyright mypy typescript-compile codecov

viser is a library for interactive 3D visualization + Python, inspired by tools like Pangolin, rviz, meshcat, and Gradio. It's designed to support applications in 3D vision and robotics.

As a standalone visualization tool, viser features include:

  • Python API for visualizing 3D primitives in a web browser.
  • Python-configurable GUI elements: buttons, checkboxes, text inputs, sliders, dropdowns, and more.
  • A meshcat and tf-inspired coordinate frame tree.

The viser.infra backend can also be used to build custom web applications. It supports:

  • Websocket / HTTP server management, on a shared port.
  • Asynchronous server/client communication infrastructure.
  • Client state persistence logic.
  • Typed serialization; synchronization between Python dataclass and TypeScript interfaces.

Installation

You can install viser with pip:

pip install viser

To run examples:

# Clone the repository.
git clone https://github.com/nerfstudio-project/viser.git

# Install the package.
# You can also install via pip: `pip install viser`.
cd ./viser
pip install -e .

# Run an example.
pip install -e .[examples]
python ./examples/02_gui.py

After an example script is running, you can connect by navigating to the printed URL (default: http://localhost:8080).

See also: our development docs.

Examples

Point cloud visualization

https://github.com/nerfstudio-project/viser/assets/6992947/df35c6ee-78a3-43ad-a2c7-1dddf83f7458

Source: ./examples/07_record3d_visualizer.py

Gaussian splatting visualization

https://github.com/nerfstudio-project/viser/assets/6992947/c51b4871-6cc8-4987-8751-2bf186bcb1ae

Source: WangFeng18/3d-gaussian-splatting and heheyas/gaussian_splatting_3d.

SMPLX visualizer

https://github.com/nerfstudio-project/viser/assets/6992947/78ba0e09-612d-4678-abf3-beaeeffddb01

Source: ./example/08_smplx_visualizer.py

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

viser-0.1.22.tar.gz (2.8 MB view details)

Uploaded Source

Built Distribution

viser-0.1.22-py3-none-any.whl (2.8 MB view details)

Uploaded Python 3

File details

Details for the file viser-0.1.22.tar.gz.

File metadata

  • Download URL: viser-0.1.22.tar.gz
  • Upload date:
  • Size: 2.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.18

File hashes

Hashes for viser-0.1.22.tar.gz
Algorithm Hash digest
SHA256 81299d447c25fc78ff3dd99706a73427b9db30894f927872165aeeb753c5b2e5
MD5 7ca7c3cf0297e4652c8c9b64315ddd4d
BLAKE2b-256 b4148426c3eaa0914e3d79f4d03b7c5eb1b54d2bf4a4045d3a859cb1e3ee65a5

See more details on using hashes here.

File details

Details for the file viser-0.1.22-py3-none-any.whl.

File metadata

  • Download URL: viser-0.1.22-py3-none-any.whl
  • Upload date:
  • Size: 2.8 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.18

File hashes

Hashes for viser-0.1.22-py3-none-any.whl
Algorithm Hash digest
SHA256 17d55e8d72111805e49081e7704b1549bbdfdcb7099ac67bc98f728b583f07e6
MD5 8a0e338e87e3d7de599f50e014403f8c
BLAKE2b-256 a1c3cdbbc00d13949e4e20d630209d37c3ab35980d79746e4299fa916c4e866e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page