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

No one assigned

    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