Skip to main content

3D visualization + Python

Project description

viser

pip install viser   •   [ API Reference ]

pyright mypy typescript pypi


viser is a library for interactive 3D visualization + Python, inspired by tools like Pangolin, rviz, meshcat, and Gradio.

As a standalone visualization tool, viser features include:

  • Web interface for easy use on remote machines.
  • Python API for sending 3D primitives to the browser.
  • Python-configurable inputs: buttons, checkboxes, text inputs, sliders, dropdowns, gizmos.
  • A meshcat and tf-inspired coordinate frame tree.

The viser.infra backend can also be used to build custom web applications (example: the original Nerfstudio viewer). 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

This version

0.1.9

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.9.tar.gz (2.5 MB view details)

Uploaded Source

Built Distribution

viser-0.1.9-py3-none-any.whl (2.6 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: viser-0.1.9.tar.gz
  • Upload date:
  • Size: 2.5 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.9.tar.gz
Algorithm Hash digest
SHA256 32d1093f70db788226f2e3d8560ad4e7d388eaa95c3c10d8b3245151d705e314
MD5 1b303b5379fb8c34e09228f16dff5b09
BLAKE2b-256 c611037d11188de9d326de379226a46229a7f59bdf1b4f74bf70f34d7d278638

See more details on using hashes here.

File details

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

File metadata

  • Download URL: viser-0.1.9-py3-none-any.whl
  • Upload date:
  • Size: 2.6 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.9-py3-none-any.whl
Algorithm Hash digest
SHA256 fb9db6cba3c3df4b646316f7950150b79465f2fd8f193054ad749136c471b3f8
MD5 85129ae73114f8bca8a89dd11d365167
BLAKE2b-256 1709f40e765481e8303391f458102a67c57c7da07d977896c7cbc0f7ef0bbd5b

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