Skip to content

Kaleido export fails intermittently in Plotly 6.x / Python 3.14 environment #443

@berkdemir

Description

@berkdemir

Description

plotly.io.to_image(..., engine="kaleido") raises:

ValueError: Image export using the "kaleido" engine requires the Kaleido package

even though Kaleido is installed and importable.

The issue disappears after downgrading Plotly and Kaleido.


Environment

  • Python: 3.14.4 (Windows 11)
  • Plotly: 6.7.0 (initial issue) → works after downgrade
  • Kaleido: 1.2.0 (initial) → works after downgrade
  • OS: Windows 11

Steps to reproduce

import plotly.graph_objects as go
import plotly.io as pio

fig = go.Figure(data=[go.Bar(y=[1, 2, 3])])

img = pio.to_image(fig, format="png", engine="kaleido")

Expected behavior

PNG image should be generated via Kaleido without errors.


Actual behavior

ValueError: Image export using the "kaleido" engine requires the Kaleido package

despite Kaleido being installed.


Workaround

pip install plotly==5.24.1 kaleido==0.2.1

After downgrade, image export works as expected.


Notes

This seems related to runtime compatibility / engine registration between:

  • Plotly 6.x
  • Kaleido 1.x
  • Python 3.14 (Windows)

Possibly related to how Kaleido engine is registered in Plotly at runtime.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions