aitviewer

library1.14.2pypypiunverified

aitviewer is a library for viewing and rendering sequences of 3D data such as SMPL bodies, point clouds, and meshes. It provides an interactive viewer with Open3D backend, supports animation and editing. Current version 1.14.2, requires Python 3.10-3.12, released under MIT license. Development appears active with monthly releases.

ai-ml storage

pip install aitviewer

github ↗homepage ↗

INSTALL

IMPORT

SIG · AITVIEWER

aitviewer

ai-mlpythonv1.14.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Viewer

✓ from aitviewer import Viewer

Main viewer class.

SMPLSequence

✓ from aitviewer.renderables import SMPLSequence

Commonly used sequence type.

Create viewer and add point clouds. Requires Open3D and data.

from aitviewer import Viewer from aitviewer.renderables import PointClouds viewer = Viewer() pcs = PointClouds.from_sequences(...) viewer.scene.add(pcs) viewer.run()

Debug

Known issues

breakingIn version 1.14.0, the underlying rendering backend switched from trimesh to Open3D. Old code using custom OpenGL callbacks or trimesh-specific rendering functions will break.

fix

Update to use Open3D geometries and viewer API. See migration guide at https://github.com/eth-ait/aitviewer/wiki/Migration-from-1.13-to-1.14

affects: >=1.14.0

deprecatedThe 'smplx_body_models' parameter in Viewer is deprecated. Use 'body_models' with a flat list of model paths instead.

fix

Change `smplx_body_models` to `body_models` and ensure the list is flat (no nested dicts).

affects: >=1.13.0

gotchaSMPLSequence requires SMPL model files (not included). If not provided, the viewer may crash silently or show a placeholder. The library looks for models in `~/.aitviewer/body_models` by default.

fix

Download SMPL models (e.g., from https://smpl.is.tue.mpg.de) and place them in the correct directory, or set the `body_models` argument in Viewer.

affects: all

Upgrade

Version history

1.14.2latest on PyPI · released May 7, 2026

Audit

Dependencies

open3drequiredCore rendering and viewer; must be installed

smplxoptionalSMPL body model support

torchoptionalPyTorch tensors for sequences

Agent activity

52 hits · last 30 days

node

Resources

githubhttps://github.com/eth-ait/aitviewer ↗

homepagehttps://github.com/eth-ait/aitviewer ↗