panopti 0.2.1

Panopti: Interactive 3D visualization in Python.

Panopti:
_{Interactive 3D Visualization in Python}

[ Documentation ] - [ PyPI ]

Panopti is a Python package for interactive 3D visualization that seamlessly supports remote development setups (e.g. through SSH). It pairs a Flask server with a React+ThreeJS frontend and is designed such that users only need to write Python code, making it painless to setup interactive experiments and scenes. All code examples and demos throughout the documentation are achieved purely using Panopti in Python -- no JavaScript required!.

Panopti supports various geometric data structures (e.g. meshes, point clouds), UI control elements (e.g. buttons, sliders, color pickers, interactive plots) that are programmable in Python, and global event callbacks (e.g. for camera movement, clicking on geometry).

Install from pip:

pip install panopti

Simple example

First start a Panopti server in a separate terminal:

python -m panopti.run_server --host localhost --port 8080

Then you can easily define your scene, for example:

import panopti
import trimesh # just for io

# create panopti client that connects to server:
viewer = panopti.connect(server_url="http://localhost:8080", viewer_id='client') 
# viewer at: http://localhost:8080/?viewer_id=client

mesh = trimesh.load('./examples/demosthenes.obj')
verts, faces = mesh.vertices, mesh.faces

# add a mesh to the scene:
viewer.add_mesh(
    vertices=verts,
    faces=faces,
    name="Statue"
)

def callback_button(viewer):
    # Update the mesh's vertices
    statue = viewer.get('Statue')
    new_verts = statue.vertices * 2.0
    statue.update(vertices=new_verts)

viewer.button(callback=callback_button, name='Click Me!')

viewer.hold() # prevent script from terminating

For more examples see Documentation or /examples

Installation

To install from pip:

pip install panopti

To install from source:

git clone https://github.com/ArmanMaesumi/panopti

# build frontend viewer
cd panopti/frontend 
npm install
npm run build
cd ..

# install python package
pip install .

Dependencies

Core dependencies:

pip install numpy eventlet requests flask flask-socketio python-socketio[client] tomli msgpack trimesh

Optional dependencies:

pip install matplotlib      # for colormap utilities
pip install plotly==5.22.0  # for plotly figure support

Doc-related dependencies:

pip install mkdocs mkdocs-material mkdocstrings mkdocstrings-python

---

Development

Details for running the local development workflow can be found in: /frontend/README.md

Cite as

@misc{panopti,
  title = {Panopti},
  author = {Arman Maesumi},
  note = {https://github.com/ArmanMaesumi/panopti},
  year = {2025}
}