| Name | vizro JSON |
| Version |
0.1.43
JSON |
| download |
| home_page | None |
| Summary | Vizro is a low-code framework for building high-quality data visualization apps. |
| upload_time | 2025-07-09 12:33:02 |
| maintainer | None |
| docs_url | None |
| author | Vizro Team |
| requires_python | >=3.9 |
| license | None |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<br><br>
<div align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/Vizro_Github_Banner_Dark_Mode.png">
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/Vizro_Github_Banner_Light_Mode.png">
<img alt="Vizro logo" src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/Vizro_Github_Banner_Light_Mode.png" width="250">
</picture>
#### Vizro is a low-code toolkit for building high-quality data visualization apps
[](https://pypi.org/project/vizro/) [](https://badge.fury.io/py/vizro) [](https://github.com/mckinsey/vizro/blob/main/LICENSE.md) [](https://vizro.readthedocs.io/) [](https://www.bestpractices.dev/projects/7858)
[Documentation](https://vizro.readthedocs.io/en/stable/) | [Get Started](https://vizro.readthedocs.io/en/stable/pages/tutorials/first_dashboard/) | [Vizro examples gallery](http://vizro.mckinsey.com/)
<picture>
<source srcset="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/vizro_spash_teaser.gif">
<img alt="Gif to demonstrate Vizro features" src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/vizro_spash_teaser_fallback.png" width="600">
</picture>
<br>
<br>
<img src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/logo_watermarks.svg" width="300">
</div>
## 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.
<div align="center">
<img src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/code_dashboard.png" width="100%"/>
</div>
Every Vizro app is defined by a simple configuration, using these high-level categories:
- **[Components](https://vizro.readthedocs.io/en/stable/pages/user-guides/components/):** charts, tables, cards, KPI indicators, forms and more.
- **[Controls](https://vizro.readthedocs.io/en/stable/pages/user-guides/controls/):** filters and parameters, using a range of selectors such as drop-down menus and sliders.
- **[Actions](https://vizro.readthedocs.io/en/stable/pages/user-guides/actions/):** interactions between components, drill-throughs, export functionality and more.
- **[Layouts](https://vizro.readthedocs.io/en/stable/pages/user-guides/layouts/):** grid layouts or flexible containers, with a range of pre-set styles.
- **[Navigation](https://vizro.readthedocs.io/en/stable/pages/user-guides/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**](https://vizro.readthedocs.io/en/stable/pages/user-guides/visual-formatting/) and [**custom components**](https://vizro.readthedocs.io/en/stable/pages/user-guides/extensions/).
Visit the ["How-to guides"](https://vizro.readthedocs.io/en/stable/pages/user-guides/install/) for a more detailed explanation of Vizro features.
## Why use Vizro?
The benefits of the Vizro toolkit include:
<div align="center">
<img src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/infographic.svg" width="800"/>
</div>
<br>
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?"](https://vizro.readthedocs.io/en/stable/pages/explanation/faq/#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?
## [Vizro framework](https://vizro.readthedocs.io/en/stable/)
**Low-code framework for building dashboards.**
The Vizro framework underpins the entire Vizro toolkit. It is a Python package (called `vizro`).
Visit the [documentation](https://vizro.readthedocs.io/en/stable/) for more details.
## [Vizro visual vocabulary](https://vizro-demo-visual-vocabulary.hf.space/)
**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](https://vizro-demo-visual-vocabulary.hf.space/) to search for charts or get inspiration.
<a href="https://vizro-demo-visual-vocabulary.hf.space/">
<img src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/toolkit_visual_vocabulary.png" width="600">
</a>
## [Vizro examples gallery](https://vizro.mckinsey.com/)
**Dashboard examples.**
The dashboard examples gallery enables you to explore Vizro in action by viewing interactive example apps. You can copy the code to use as a template or starter for your next dashboard.
Visit the [dashboard examples gallery](https://vizro.mckinsey.com/) to see the dashboards in action.
<a href="https://vizro.mckinsey.com/">
<img src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/toolkit_dashboard_examples.png" width="600">
</a>
## [Vizro-MCP](https://github.com/mckinsey/vizro/tree/main/vizro-mcp)
**A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 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.
<img src="https://raw.githubusercontent.com/mckinsey/vizro/main/vizro-mcp/assets/vizro-mcp.gif" alt="Vizro MCP Demo" width="600">
## [Vizro-AI](https://vizro.readthedocs.io/projects/vizro-ai/)
**Use LLMs to generate charts and dashboards.**
> **Vizro-AI dashboard generation is no longer actively developed and is superseded by [Vizro-MCP](https://github.com/mckinsey/vizro/tree/main/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](https://vizro.readthedocs.io/projects/vizro-ai/) for more details.
<picture>
<source srcset="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/toolkit_vizro_ai.gif">
<img alt="Gif to demonstrate Vizro-AI" src="https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/toolkit_vizro_ai_fallback.png" width="600">
</picture>
## Installation and first steps
```console
pip install vizro
```
See the [installation guide](https://vizro.readthedocs.io/en/stable/pages/user-guides/install/) for more information.
The [get started documentation](https://vizro.readthedocs.io/en/stable/pages/tutorials/first-dashboard/) explains how to create your first dashboard.
## Packages
This repository is a monorepo containing the following packages:
| Folder | Version | Documentation |
| :------------------------: | :-------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------: |
| [vizro-core](./vizro-core) | [](https://badge.fury.io/py/vizro) | [Vizro Docs](https://vizro.readthedocs.io/en/stable/) |
| [vizro-ai](./vizro-ai) | [](https://badge.fury.io/py/vizro-ai) | [Vizro-AI Docs](https://vizro.readthedocs.io/projects/vizro-ai/) |
| [vizro-mcp](./vizro-mcp) | [](https://badge.fury.io/py/vizro-mcp) | [Vizro-MCP Docs](https://github.com/mckinsey/vizro/blob/main/vizro-mcp/README.md) |
## Community and development
We encourage you to ask and discuss any technical questions via the [GitHub Issues](https://github.com/mckinsey/vizro/issues). This is also the place where you can submit bug reports or request new features.
## Want to contribute to Vizro?
The [contributing guide](https://vizro.readthedocs.io/en/stable/pages/explanation/contributing/) explains how you can contribute to Vizro.
You can also view current and former contributors [here](https://vizro.readthedocs.io/en/stable/pages/explanation/authors/).
## Want to report a security vulnerability?
See our [security policy](https://github.com/mckinsey/vizro/security/policy).
## License
`vizro` is distributed under the terms of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).
Raw data
{
"_id": null,
"home_page": null,
"name": "vizro",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Vizro Team",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/2c/0b/5813fd0dcdb21330eb6cfd0b4ea0579ed9ebca701558632228674c3f9703/vizro-0.1.43.tar.gz",
"platform": null,
"description": "<br><br>\n\n<div align=\"center\">\n\n<picture>\n <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/Vizro_Github_Banner_Dark_Mode.png\">\n <source media=\"(prefers-color-scheme: light)\" srcset=\"https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/Vizro_Github_Banner_Light_Mode.png\">\n <img alt=\"Vizro logo\" src=\"https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/Vizro_Github_Banner_Light_Mode.png\" width=\"250\">\n</picture>\n\n#### Vizro is a low-code toolkit for building high-quality data visualization apps\n\n[](https://pypi.org/project/vizro/) [](https://badge.fury.io/py/vizro) [](https://github.com/mckinsey/vizro/blob/main/LICENSE.md) [](https://vizro.readthedocs.io/) [](https://www.bestpractices.dev/projects/7858)\n\n[Documentation](https://vizro.readthedocs.io/en/stable/) | [Get Started](https://vizro.readthedocs.io/en/stable/pages/tutorials/first_dashboard/) | [Vizro examples gallery](http://vizro.mckinsey.com/)\n\n<picture>\n <source srcset=\"https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/vizro_spash_teaser.gif\">\n <img alt=\"Gif to demonstrate Vizro features\" src=\"https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/vizro_spash_teaser_fallback.png\" width=\"600\">\n</picture>\n<br>\n<br>\n<img src=\"https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/logo_watermarks.svg\" width=\"300\">\n</div>\n\n## What is Vizro?\n\nVizro is an open-source Python-based toolkit.\n\nUse it to build beautiful and powerful data visualization apps quickly and easily, without needing advanced engineering or visual design expertise.\n\nThen customize and deploy your app to production at scale.\n\nIn 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.\n\n<div align=\"center\">\n<img src=\"https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/code_dashboard.png\" width=\"100%\"/>\n</div>\n\nEvery Vizro app is defined by a simple configuration, using these high-level categories:\n\n- **[Components](https://vizro.readthedocs.io/en/stable/pages/user-guides/components/):** charts, tables, cards, KPI indicators, forms and more.\n- **[Controls](https://vizro.readthedocs.io/en/stable/pages/user-guides/controls/):** filters and parameters, using a range of selectors such as drop-down menus and sliders.\n- **[Actions](https://vizro.readthedocs.io/en/stable/pages/user-guides/actions/):** interactions between components, drill-throughs, export functionality and more.\n- **[Layouts](https://vizro.readthedocs.io/en/stable/pages/user-guides/layouts/):** grid layouts or flexible containers, with a range of pre-set styles.\n- **[Navigation](https://vizro.readthedocs.io/en/stable/pages/user-guides/navigation/):** a range of app layout and navigation settings, including nested page hierarchies.\n\nConfiguration can be written in multiple formats including **Pydantic models**, **JSON**, **YAML** or **Python dictionaries** for added flexibility of implementation.\n\nOptional high-code extensions enable almost infinite customization in a modular way, combining the best of low-code and high-code - including bespoke [**visual formatting**](https://vizro.readthedocs.io/en/stable/pages/user-guides/visual-formatting/) and [**custom components**](https://vizro.readthedocs.io/en/stable/pages/user-guides/extensions/).\n\nVisit the [\"How-to guides\"](https://vizro.readthedocs.io/en/stable/pages/user-guides/install/) for a more detailed explanation of Vizro features.\n\n## Why use Vizro?\n\nThe benefits of the Vizro toolkit include:\n\n<div align=\"center\">\n<img src=\"https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/infographic.svg\" width=\"800\"/>\n</div>\n<br>\n\nVizro helps you to build data visualization apps that are:\n\n**Quick and easy**\n\nBuild 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.\n\n**Beautiful and powerful**\n\nBuild 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.\n\n**Flexible**\n\nBenefit from the capabilities and flexibility of open-source packages. Use the trusted dependencies of Plotly, Dash, and Pydantic.\n\n**Customizable**\n\nAlmost infinite control for advanced users. Use Python, JavaScript, HTML and CSS code extensions.\n\n**Scalable**\n\nRapidly prototype and deploy to production. Use the in-built production-grade capabilities of Plotly, Dash and Pydantic.\n\nVisit [\"Why should I use Vizro?\"](https://vizro.readthedocs.io/en/stable/pages/explanation/faq/#why-should-i-use-vizro) for a more detailed explanation of Vizro use cases.\n\n## When to use Vizro?\n\nUse 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:\n\n- Have an app that looks beautiful and professional by default.\n- Enjoy the simplicity of low-code, plus the option to customize with code almost infinitely.\n- Rapidly create prototypes which are production-ready and easy to deploy at scale.\n\n## How to use Vizro?\n\n## [Vizro framework](https://vizro.readthedocs.io/en/stable/)\n\n**Low-code framework for building dashboards.**\n\nThe Vizro framework underpins the entire Vizro toolkit. It is a Python package (called `vizro`).\n\nVisit the [documentation](https://vizro.readthedocs.io/en/stable/) for more details.\n\n## [Vizro visual vocabulary](https://vizro-demo-visual-vocabulary.hf.space/)\n\n**Chart examples.**\n\nThe 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.\n\nVisit the [visual vocabulary](https://vizro-demo-visual-vocabulary.hf.space/) to search for charts or get inspiration.\n\n<a href=\"https://vizro-demo-visual-vocabulary.hf.space/\">\n<img src=\"https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/toolkit_visual_vocabulary.png\" width=\"600\">\n</a>\n\n## [Vizro examples gallery](https://vizro.mckinsey.com/)\n\n**Dashboard examples.**\n\nThe dashboard examples gallery enables you to explore Vizro in action by viewing interactive example apps. You can copy the code to use as a template or starter for your next dashboard.\n\nVisit the [dashboard examples gallery](https://vizro.mckinsey.com/) to see the dashboards in action.\n\n<a href=\"https://vizro.mckinsey.com/\">\n<img src=\"https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/toolkit_dashboard_examples.png\" width=\"600\">\n</a>\n\n## [Vizro-MCP](https://github.com/mckinsey/vizro/tree/main/vizro-mcp)\n\n**A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for Vizro.**\n\nVizro-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.\n\nCompatible with MCP-enabled LLM clients such as Cursor or Claude Desktop.\n\n<img src=\"https://raw.githubusercontent.com/mckinsey/vizro/main/vizro-mcp/assets/vizro-mcp.gif\" alt=\"Vizro MCP Demo\" width=\"600\">\n\n## [Vizro-AI](https://vizro.readthedocs.io/projects/vizro-ai/)\n\n**Use LLMs to generate charts and dashboards.**\n\n> **Vizro-AI dashboard generation is no longer actively developed and is superseded by [Vizro-MCP](https://github.com/mckinsey/vizro/tree/main/vizro-mcp). Vizro-AI supports only chart generation from version 0.4.0.**\n\nVizro-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.\n\nVisit the [Vizro-AI documentation](https://vizro.readthedocs.io/projects/vizro-ai/) for more details.\n\n<picture>\n <source srcset=\"https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/toolkit_vizro_ai.gif\">\n <img alt=\"Gif to demonstrate Vizro-AI\" src=\"https://raw.githubusercontent.com/mckinsey/vizro/main/.github/images/toolkit_vizro_ai_fallback.png\" width=\"600\">\n</picture>\n\n## Installation and first steps\n\n```console\npip install vizro\n```\n\nSee the [installation guide](https://vizro.readthedocs.io/en/stable/pages/user-guides/install/) for more information.\n\nThe [get started documentation](https://vizro.readthedocs.io/en/stable/pages/tutorials/first-dashboard/) explains how to create your first dashboard.\n\n## Packages\n\nThis repository is a monorepo containing the following packages:\n\n| Folder | Version | Documentation |\n| :------------------------: | :-------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------: |\n| [vizro-core](./vizro-core) | [](https://badge.fury.io/py/vizro) | [Vizro Docs](https://vizro.readthedocs.io/en/stable/) |\n| [vizro-ai](./vizro-ai) | [](https://badge.fury.io/py/vizro-ai) | [Vizro-AI Docs](https://vizro.readthedocs.io/projects/vizro-ai/) |\n| [vizro-mcp](./vizro-mcp) | [](https://badge.fury.io/py/vizro-mcp) | [Vizro-MCP Docs](https://github.com/mckinsey/vizro/blob/main/vizro-mcp/README.md) |\n\n## Community and development\n\nWe encourage you to ask and discuss any technical questions via the [GitHub Issues](https://github.com/mckinsey/vizro/issues). This is also the place where you can submit bug reports or request new features.\n\n## Want to contribute to Vizro?\n\nThe [contributing guide](https://vizro.readthedocs.io/en/stable/pages/explanation/contributing/) explains how you can contribute to Vizro.\n\nYou can also view current and former contributors [here](https://vizro.readthedocs.io/en/stable/pages/explanation/authors/).\n\n## Want to report a security vulnerability?\n\nSee our [security policy](https://github.com/mckinsey/vizro/security/policy).\n\n## License\n\n`vizro` is distributed under the terms of the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).\n",
"bugtrack_url": null,
"license": null,
"summary": "Vizro is a low-code framework for building high-quality data visualization apps.",
"version": "0.1.43",
"project_urls": {
"Documentation": "https://github.com/mckinsey/vizro#readme",
"Issues": "https://github.com/mckinsey/vizro/issues",
"Source": "https://github.com/mckinsey/vizro"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "fdd5c526fd2da1b40640bb13687ce33d1202e7862110ec999c0822a91a2b3be2",
"md5": "bba679475ed5f875cb7b90eaaef359cc",
"sha256": "f51f435847eb68b33a5b5270527187d61b750ffab732f484229ec19957704460"
},
"downloads": -1,
"filename": "vizro-0.1.43-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bba679475ed5f875cb7b90eaaef359cc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 924678,
"upload_time": "2025-07-09T12:32:59",
"upload_time_iso_8601": "2025-07-09T12:32:59.173820Z",
"url": "https://files.pythonhosted.org/packages/fd/d5/c526fd2da1b40640bb13687ce33d1202e7862110ec999c0822a91a2b3be2/vizro-0.1.43-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2c0b5813fd0dcdb21330eb6cfd0b4ea0579ed9ebca701558632228674c3f9703",
"md5": "732eecace3cdaa9667f649a154b0572a",
"sha256": "cea556458ab66f898694c456106e2c1fa6dea262fc774c3fec00f879c2340053"
},
"downloads": -1,
"filename": "vizro-0.1.43.tar.gz",
"has_sig": false,
"md5_digest": "732eecace3cdaa9667f649a154b0572a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 72780693,
"upload_time": "2025-07-09T12:33:02",
"upload_time_iso_8601": "2025-07-09T12:33:02.668951Z",
"url": "https://files.pythonhosted.org/packages/2c/0b/5813fd0dcdb21330eb6cfd0b4ea0579ed9ebca701558632228674c3f9703/vizro-0.1.43.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-09 12:33:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mckinsey",
"github_project": "vizro#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "vizro"
}
