vedo

2026.6.1 verified Fri May 01 auth: no python

A Python module for scientific visualization, analysis of 3D objects and point clouds, built on VTK. Current version is 2026.6.1, with a monthly release cadence.

pip install vedo

Common errors

error AttributeError: module 'vedo' has no attribute 'Sphere' ↓

cause Importing vedo incorrectly or using an old version where Sphere is not exposed at top level.

fix

Use from vedo import Sphere or upgrade to a recent version (>=2020).

error ModuleNotFoundError: No module named 'vedo.file_io' ↓

cause Using an old version of vedo (pre-2023.4.5) where the module was named 'io'.

fix

Use from vedo.io import ... for old versions, or upgrade to >=2023.4.5 and use vedo.file_io.

error RuntimeError: This method is not available for this type of mesh. ↓

cause Calling a method that expects a Mesh object on a Volume or other type.

fix

Check the type of your object (type(obj)) and use appropriate methods for Mesh, Volume, etc.

Warnings

breaking In v2023.5.0, .points() is renamed to .vertices, .faces() to .cells, .cell_centers() to .cell_centers (property), .normals() and .lines() are renamed similarly. Old code will break. ↓

fix Replace .points() with .vertices, .faces() with .cells, etc.

breaking In v2024.5.0, plt.actors renamed to plt.objects. ↓

fix Use plt.objects instead of plt.actors.

deprecated CornerAnnotation class removed in v2026.6.1; use Text2D instead. ↓

fix Replace CornerAnnotation with Text2D.

breaking In v2023.4.5, module io.py renamed to file_io.py to avoid conflicting with stdlib io. ↓

fix Use from vedo.file_io import ... instead of from vedo.io import ...

gotcha Trame integration may require additional dependencies (trame, trame-vuetify). Not installed by default. ↓

fix Install with pip install vedo[trame] or manually install trame.

Imports

vedo
wrong
```
from vedo import *
```
correct
```
import vedo
```
Star imports are discouraged; use explicit imports.
Mesh
wrong
```
from vedo.shapes import Mesh
```
correct
```
from vedo import Mesh
```
Mesh is available directly from vedo, not from vedo.shapes.
Plotter
wrong
```
from vedo.plotter import Plotter
```
correct
```
from vedo import Plotter
```
Plotter is exposed at the top-level vedo module.
dataobjects
```
import vedo as vd; vd.dataobjects
```
No common wrong import; used for built-in datasets.

Quickstart

Creates and displays a sphere using vedo.

import vedo
from vedo import Mesh

# Load a simple sphere mesh
sphere = vedo.Sphere()
# Show it
sphere.show().close()