---
id: kaleido
version: "1.3.0"
license: The MIT License (MIT) Copyright (c) Plotly, Inc Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to… (full text in the JSON record)
license_treatment: unclear
maintenance: active
---

# kaleido — Plotly graph export library

License: unclear · Maintenance: active · Downloads: 11.5M/mo

## What it is and what it does

Kaleido is a cross-platform library that converts figures into static image files in formats like PNG, SVG, and PDF. It is primarily designed to work with Plotly.py but can also be used directly in Python code. The library uses Chrome as its rendering engine, which must be installed separately on the system; Kaleido provides tooling to obtain a compatible Chrome version if needed.

The package offers both async and synchronous APIs for image generation. You can create a Kaleido instance to manage multiple concurrent exports with configurable process counts and timeouts, or use shortcut functions for simpler one-off exports. Image options such as scale, format, width, and height can be customized, and error handling can be configured to either halt on the first failure or collect errors and continue processing.

Use it for:

- Export dashboards and visualizations to static images for reports, presentations, or archival.
- Batch-convert multiple figures to PNG or PDF in parallel using the async API with configurable worker processes.
- Generate publication-ready charts in SVG or PDF format with custom dimensions and scaling for documents.
- Automate static image export in CI/CD pipelines or server-side applications.
- Create static snapshots of visualizations for embedding in web pages or email.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Kaleido generates static images (PNG, SVG, PDF, etc.) from figures, primarily for use with Plotly.py. It requires Chrome to be installed on the system.

Yes. Kaleido is actively maintained, has low install friction, carries no security vulnerabilities, and is widely used (top_5000 tier). It solves a specific, well-defined problem—exporting figures to static images—with a straightforward API. The main prerequisite is Chrome installation, which is clearly documented and can be automated. Install it if you need to export visualizations to static formats.

## Install

pip install kaleido
uv add kaleido
poetry add kaleido

## Installing kaleido

Before you install: Low install friction with a pure-Python wheel. Maintenance is active with recent releases. The main runtime requirement is Chrome, which must be installed separately; Kaleido provides a command-line tool and Python function to install a compatible version if needed.

License in practice: Licensed under the MIT License, which permits free use, modification, and redistribution with minimal restrictions. No notable licensing constraints for typical use.

Quickstart:

import asyncio
import kaleido

async def export():
  async with kaleido.Kaleido(n=4, timeout=90) as k:
    await k.write_fig(fig, path="./", opts={"format":"jpg"})

asyncio.run(export())

Chrome must be installed on the system. If not present, run `kaleido_get_chrome` or call `kaleido.get_chrome_sync()` in Python to install a compatible version.

Verify before relying:

- Whether the four runtime dependencies (choreographer, logistro, orjson, packaging) are internal utilities or external packages with their own maintenance status.
- Performance characteristics when processing large batches of figures or high-resolution exports.
- Compatibility with headless environments or containerized deployments beyond the Chrome requirement.

## Package facts

- License: The MIT License (MIT) Copyright (c) Plotly, Inc Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to… (full text in the JSON record) (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 11.5M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

static image export, convert figures to png pdf svg, figure rendering, generate static charts, graph export, image generation, image-export, async-rendering

[View on SkillFed](https://skillfed.io/packages/kaleido) · [View on PyPI](https://pypi.org/project/kaleido/)