Registry / observability / meshcat-shapes

meshcat-shapes

JSON →

library1.0.0pypypi✓ verified 85d ago

Useful shapes to decorate MeshCat scenes. Current version 1.0.0, stable. Release cadence is irregular.

observability

pip install meshcat-shapes

github ↗package ↗changelog ↗

INSTALL

IMPORT

SIG · MESHCAT-SHAPES

meshcat-shapes

observabilitypythonv1.0.0

Install

8.6s avg

Import

2238ms

Disk

189MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.0.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 2.306s · 196.4MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 8.6s · import 2.170s · 190MB

189MB installed

● package 189MB

Code

Verified usage

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

MeshcatShape

✓ import meshcat_shapes

✗ import meshcat.shapes

Namespace used to be part of meshcat, now separate package

frame

✓ from meshcat_shapes import frame

point

✓ from meshcat_shapes import point

textarea

✓ from meshcat_shapes import textarea

Added in v0.3.0

Creates a MeshCat visualizer and adds a frame, a point, and a text area.

import meshcat import meshcat_shapes vis = meshcat.Visualizer() vis.open() # Draw a 3-axis frame at origin meshcat_shapes.frame(vis, "world/frame", opacity=1.0) # Draw a point meshcat_shapes.point(vis, "world/point", radius=0.05, color=0xff0000) # Draw a text area meshcat_shapes.textarea(vis, "world/text", "Hello, MeshCat!", width=0.5, height=0.2)

Debug

Known issues

breakingIn v1.0.0, the minimum Python version was bumped to 3.9. Older Python versions (3.7, 3.8) are no longer supported.

fix

Upgrade Python to 3.9 or later.

affects: >0.3.0,<1.0.0

deprecatedThe package name was previously part of the meshcat namespace. Ensure you import 'meshcat_shapes', not 'meshcat.shapes'.

fix

Use 'import meshcat_shapes' or 'from meshcat_shapes import ...'.

affects: all

gotchaThe 'textarea' shape requires the 'meshcat' visualizer to be open and supports only basic ASCII text (no Unicode).

fix

Use ASCII characters only for text content.

affects: >=0.3.0

gotchaAll shapes must be added before the visualizer is closed or the scene is finalized. Adding after closing may not render.

fix

Add all shapes before calling vis.close() or similar finalization.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'meshcat.shapes'

Incorrect import path; meshcat-shapes is a separate package.

fix

Install with 'pip install meshcat-shapes' and import as 'import meshcat_shapes'.

AttributeError: module 'meshcat_shapes' has no attribute 'frame'

The 'frame' function might have been removed or renamed in an older version. Ensure you have the latest version (v1.0.0) installed.

fix

Upgrade: 'pip install --upgrade meshcat-shapes' and check 'from meshcat_shapes import frame'.

TypeError: textarea() got an unexpected keyword argument 'fontsize'

The 'textarea' function does not accept a 'fontsize' parameter; only 'width' and 'height' control size.

fix

Remove 'fontsize'. Use 'width' and 'height' to adjust the text area dimensions.

ValueError: Radius must be positive

Calling 'point()' with radius <= 0.

fix

Provide a positive radius value (e.g., radius=0.05).

Upgrade

Version history

1.0.0latest on PyPI · released Jun 30, 2025

Audit

Dependencies

meshcatrequiredRequired for scene interaction and visualization

Agent activity

10 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/stephane-caron/meshcat-shapes ↗

packagehttps://pypi.org/project/meshcat-shapes/ ↗

changeloghttps://github.com/stephane-caron/meshcat-shapes/blob/master/CHANGELOG.md ↗