Vizro logo

Vizro is a low-code toolkit for building high-quality data visualization apps

Python version PyPI version License Documentation OpenSSF Best Practices

Documentation | Get Started

Gif to demonstrate Vizro features

What is Vizro?

Vizro is an open-source Python-based toolkit.

Use it to build beautiful and powerful data visualization apps quickly and easily, without needing advanced engineering or visual design expertise.

Then customize and deploy your app to production at scale.

In just a few lines of simple low-code configuration, with in-built visual design best practices, you can quickly assemble high-quality, multi-page prototypes, that are production-ready.

Every Vizro app is defined by a simple configuration, using these high-level categories:

  • Components: charts, tables, cards, KPI indicators, forms and more.
  • Controls: filters and parameters, using a range of selectors such as drop-down menus and sliders.
  • Actions: interactions between components, drill-throughs, export functionality and more.
  • Layouts: grid layouts or flexible containers, with a range of pre-set styles.
  • Navigation: a range of app layout and navigation settings, including nested page hierarchies.

Configuration can be written in multiple formats including Pydantic models, JSON, YAML or Python dictionaries for added flexibility of implementation.

Optional high-code extensions enable almost infinite customization in a modular way, combining the best of low-code and high-code - including bespoke visual formatting and custom components.

Visit the "How-to guides" for a more detailed explanation of Vizro features.

Why use Vizro?

The benefits of the Vizro toolkit include:


Vizro helps you to build data visualization apps that are:

Quick and easy

Build apps in minutes. Use a few lines of simple configuration (via Pydantic models, JSON, YAML, or Python dictionaries) in place of thousands of lines of code.

Beautiful and powerful

Build high-quality multi-page apps without needing advanced engineering or visual design expertise. Use powerful features of production-grade BI tools, with in-built visual design best practices.

Flexible

Benefit from the capabilities and flexibility of open-source packages. Use the trusted dependencies of Plotly, Dash, and Pydantic.

Customizable

Almost infinite control for advanced users. Use Python, JavaScript, HTML and CSS code extensions.

Scalable

Rapidly prototype and deploy to production. Use the in-built production-grade capabilities of Plotly, Dash and Pydantic.

Visit "Why should I use Vizro?" for a more detailed explanation of Vizro use cases.

When to use Vizro?

Use Vizro when you need to combine the speed and ease of low-code Python tools, with production capabilities of JavaScript and BI tools, and the freedom of open source:

  • Have an app that looks beautiful and professional by default.
  • Enjoy the simplicity of low-code, plus the option to customize with code almost infinitely.
  • Rapidly create prototypes which are production-ready and easy to deploy at scale.

How to use Vizro?

Explore a few live demos to see different Vizro dashboards in action:

Basic Dashboard
Basic Dashboard
Try it live 		Visual Vocabulary
Visual Vocabulary
Try it live 		BI Dashboard
BI Dashboard
Try it live
Call Center Dashboard
Call Center Dashboard
Try it live 		KPI Dashboard
KPI Dashboard
Try it live 		Features Dashboard
Features Dashboard
Try it live

Browse the full Vizro Gallery for more examples.

Vizro framework

Low-code framework for building dashboards.

The Vizro framework underpins the entire Vizro toolkit. It is a Python package (called vizro).

Visit the documentation for more details.

Vizro visual vocabulary

Chart examples.

The visual vocabulary helps you to decide which chart type to use for your requirements, and offers sample code to create these charts with Plotly or embed them into a Vizro dashboard.

Visit the visual vocabulary to search for charts or get inspiration.

Vizro-MCP

A Model Context Protocol (MCP) server for Vizro.

Vizro-MCP works alongside an LLM to help you create Vizro dashboards and charts. It provides tools and templates to create a functioning Vizro chart or dashboard step-by-step.

Compatible with MCP-enabled LLM clients such as Cursor or Claude Desktop.

Vizro MCP Demo

Vizro-AI

Use LLMs to generate charts and dashboards.

Vizro-AI dashboard generation is no longer actively developed and is superseded by Vizro-MCP. Vizro-AI supports only chart generation from version 0.4.0.

Vizro-AI is a separate package (called vizro_ai) that extends Vizro to incorporate LLMs. Use it to build interactive Vizro charts and dashboards, by simply describing what you need in plain English or other languages.

Visit the Vizro-AI documentation for more details.

Gif to demonstrate Vizro-AI

Installation and first steps

pip install vizro

See the installation guide for more information.

The get started documentation explains how to create your first dashboard.

For AI agents and LLMs

If you are an AI agent or LLM building Vizro apps, start with the Vizro for LLMs cheatsheet — a single-page reference covering the minimum runnable app, model index, action index, @capture decorator matrix, and top errors with fixes. The llms.txt file provides a machine-readable index of the full documentation, and every documentation page returns clean Markdown when fetched with the Accept: text/markdown request header.

Packages

This repository is a monorepo containing the following packages:

Folder Version Documentation
vizro-core PyPI version Vizro Docs
vizro-ai PyPI version Vizro-AI Docs
vizro-mcp PyPI version Vizro-MCP Docs

Community and development

We encourage you to ask and discuss any technical questions via the GitHub Issues. This is also the place where you can submit bug reports or request new features.

Want to contribute to Vizro?

The contributing guide explains how you can contribute to Vizro.

You can also view current and former contributors here.

Want to report a security vulnerability?

See our security policy.

License

vizro is distributed under the terms of the Apache License 2.0.

Project links

Data verified by PyPI on Jul 30, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

4 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for li.nguyen from gravatar.com li.nguyen Avatar for maxschulz-COL from gravatar.com maxschulz-COL Avatar for quantumblacklabs from gravatar.com quantumblacklabs
+1 more Avatar for stichbury from gravatar.com stichbury

Credits

Author: Vizro Team

GitHub Statistics

Data verified by PyPI on Jul 30, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

Requires

Python >=3.10

Provides Extra

kedro

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vizro-0.1.60.tar.gz (923.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vizro-0.1.60-py3-none-any.whl (974.7 kB view details)

Uploaded Python 3

File details

Details for the file vizro-0.1.60.tar.gz.

File metadata

  • Download URL: vizro-0.1.60.tar.gz
  • Upload date:
  • Size: 923.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for vizro-0.1.60.tar.gz
Algorithm Hash digest
SHA256 dcd62dae4f330f75a9e8ba0d846246fee556350918e322810a0f7047c937b60c
MD5 09c1600afad227b60eefabd23eca5353
BLAKE2b-256 2748a1b49b41bcd639a8d9228a13b1b677a24a9613093742bdf8ffb4cc4f3bae

See more details on using hashes here.

Provenance

The following attestation bundles were made for vizro-0.1.60.tar.gz:

Publisher: release-if-needed.yml on mckinsey/vizro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file vizro-0.1.60-py3-none-any.whl.

File metadata

  • Download URL: vizro-0.1.60-py3-none-any.whl
  • Upload date:
  • Size: 974.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for vizro-0.1.60-py3-none-any.whl
Algorithm Hash digest
SHA256 c555344e7c2f3d089f93190e53377d6ac471a76d8c9225e8b7e935b0ed6f2c68
MD5 01ec31016392ad057cc5a898310b9d47
BLAKE2b-256 927748b808023a5db6af5b159adbdbc81d4ef14a1b5989c0dc6f1c6f33db5fb4

See more details on using hashes here.

Provenance

The following attestation bundles were made for vizro-0.1.60-py3-none-any.whl:

Publisher: release-if-needed.yml on mckinsey/vizro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.60 This release

2 files

0.1.59

2 files

0.1.58

2 files

0.1.57

2 files

0.1.56

2 files

0.1.55

2 files

0.1.54

2 files

0.1.53

2 files

0.1.52

2 files

0.1.51

2 files

0.1.50

2 files

0.1.49

2 files

0.1.48

2 files

0.1.47

2 files

0.1.46

2 files

0.1.45

2 files

0.1.44

2 files

0.1.43

2 files

0.1.42

2 files

0.1.41

2 files

0.1.40

2 files

0.1.39

2 files

0.1.38

2 files

0.1.37

2 files

0.1.36

2 files

0.1.35

2 files

0.1.34

2 files

0.1.33

2 files

0.1.32

2 files

0.1.31

2 files

0.1.30

2 files

0.1.29

2 files

0.1.28

2 files

0.1.27

2 files

0.1.26

2 files

0.1.25

2 files

0.1.24

2 files

0.1.23

2 files

0.1.22

2 files

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

0.0.1

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page