conda install -c conda-forge plotly python-kaleido

[Lucky8-GH]

plotly and python-kaleido Install in a brand new Conda env

❯❯❯ conda install -c conda-forge plotly python-kaleido -y
2 channel Terms of Service accepted
Channels:
 - conda-forge
 - defaults
Platform: osx-arm64
Collecting package metadata (repodata.json): done
Solving environment: done

## Package Plan ##

  environment location: /opt/miniconda3/envs/bsa3

  added / updated specs:
    - plotly
    - python-kaleido


The following NEW packages will be INSTALLED:

  narwhals           conda-forge/noarch::narwhals-1.48.0-pyhe01879c_0 
  packaging          conda-forge/noarch::packaging-25.0-pyh29332c3_1 
  plotly             conda-forge/noarch::plotly-6.2.0-pyhd8ed1ab_0 
  python-kaleido     conda-forge/noarch::python-kaleido-1.0.0-pyhe01879c_0 



Downloading and Extracting Packages:

Preparing transaction: done
Verifying transaction: done
Executing transaction: done

Packages that have been installed in the current environment

❯❯❯ conda list
# packages in environment at /opt/miniconda3/envs/bsa3:
#
# Name                     Version          Build               Channel
bzip2                      1.0.8            h99b78c6_7          conda-forge
ca-certificates            2025.7.14        hbd8a1cb_0          conda-forge
choreographer              1.0.9            pyhe01879c_0        conda-forge
libexpat                   2.7.1            hec049ff_0          conda-forge
libffi                     3.4.6            h1da3d7d_1          conda-forge
liblzma                    5.8.1            h39f12f2_2          conda-forge
libsqlite                  3.50.3           hf8de324_0          conda-forge
libzlib                    1.3.1            h8359307_2          conda-forge
logistro                   1.1.0            pyhe01879c_0        conda-forge
narwhals                   1.48.0           pyhe01879c_0        conda-forge
ncurses                    6.5              h5e97a16_3          conda-forge
openssl                    3.5.1            h81ee809_0          conda-forge
orjson                     3.11.0           py312h6f58b40_0     conda-forge
packaging                  25.0             pyh29332c3_1        conda-forge
pip                        25.1.1           pyh8b19718_0        conda-forge
plotly                     6.2.0            pyhd8ed1ab_0        conda-forge
python                     3.12.11          hc22306f_0_cpython  conda-forge
python-kaleido             1.0.0            pyhe01879c_0        conda-forge
python_abi                 3.12             8_cp312             conda-forge
readline                   8.2              h1d1bf99_2          conda-forge
setuptools                 80.9.0           pyhff2d567_0        conda-forge
simplejson                 3.20.1           py312hea69d52_0     conda-forge
tk                         8.6.13           h892fb3f_2          conda-forge
tzdata                     2025b            h78e105d_0          conda-forge
wheel                      0.45.1           pyhd8ed1ab_1        conda-forge

Create a file named test.py

import plotly.graph_objects as go

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


fig.write_image("fig.png")

❯❯❯ python3 test.py
/Users/gh/Desktop/TestFile/test.py:6: DeprecationWarning:


Support for Kaleido versions less than 1.0.0 is deprecated and will be removed after September 2025.
Please upgrade Kaleido to version 1.0.0 or greater (`pip install 'kaleido>=1.0.0'` or `pip install 'plotly[kaleido]'`).


Traceback (most recent call last):
  File "/Users/gh/Desktop/TestFile/test.py", line 6, in <module>
    fig.write_image("fig.png")
  File "/opt/miniconda3/envs/bsa3/lib/python3.12/site-packages/plotly/basedatatypes.py", line 3895, in write_image
    return pio.write_image(self, *args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/miniconda3/envs/bsa3/lib/python3.12/site-packages/plotly/io/_kaleido.py", line 510, in write_image
    img_data = to_image(
               ^^^^^^^^^
  File "/opt/miniconda3/envs/bsa3/lib/python3.12/site-packages/plotly/io/_kaleido.py", line 398, in to_image
    img_bytes = scope.transform(
                ^^^^^^^^^^^^^^^
AttributeError: 'NoneType' object has no attribute 'transform'

Install the requirement package through pip in a brand-new Conda environment: 'pip install kaleido plotly', and then execute the command:' python3 test.py', which will get the correct graph and will not cause any errors in the process.

[gvwilson]

possibly related to #358 - @LiamConnors do we need to bump docs about conda installs?

[LiamConnors]

possibly related to #358 - @LiamConnors do we need to bump docs about conda installs?

I don't think it's a docs issue. The docs command for conda installs should install the latest kaleido. Though we can remove the command for now, if this issue is happening for all users, until it's fixed. I see the same issue as reported on this and #358

[takluyver]

I think this is related to #358, because plotly checks the same info as pip is using to determine which version of Kaleido is installed, and then takes different code paths for Kaleido 1.x vs. 0.x. So it actually has Kaleido 1.x installed, but plotly thinks it's version 0.x.

It looks like the root cause is that Kaleido uses one of these 'clever' tools to pull the version number from git, and that was overlooked when writing/updating the conda-forge recipe. Of course the version number is 'just metadata', so the build doesn't fail, it just gets a default 0.0.0 instead.

[takluyver]

I think this should let it get the correct version number: conda-forge/python-kaleido-feedstock#14