Creates a static visualization of your pipeline
Kedro-Static-Viz creates a static website for your Kedro data pipelines. Kedro static viz is a very small python cli that makes your kedro-viz generated pipeline.json data available to a static appication built with gatsbyjs. The benefit of this is that it it can be built inside of a ci service such as github actions and deployed to a number to static file hosts such as Netlify, Now.sh, github pages, S3. Free options are endless these days. By default the site will be built to the
On every push to master in this repo static-viz.kedro.dev is built and deployed.
static_viz function is callable from inside your project directory.
from kedro_static_viz import static_viz static_viz()
from kedro_static_viz.hooks import StaticViz class ProjectContext(KedroContext): project_name = "kedro0160" project_version = "0.16.1" package_name = "kedro0160" hooks = [ StaticViz() ]
How do I install and use Kedro-Static-Viz?
As a Kedro Python plugin
Kedro-Static-Viz is available as a Python plugin named
The following conditions must be true in order to visualise your pipeline:
- Your project directory must be available to the Kedro-Static-Viz plugin.
- You must be using a Kedro data pipelines project structure with a complete Data Catalog, nodes and pipeline structure.
To install it:
pip install kedro-static-viz
This will install
kedro as a dependency, and add
kedro static-viz as an additional CLI command.
To visualise your pipeline, go to your project root directory and install the project-specific dependencies by running:
This will install the dependencies specified in
requirements.txt in your Kedro environment (see the Kedro documentation for how to set up your Python virtual environment).
Finally, run the following command from the project directory to visualise your pipeline:
This command will run kedro_viz.server on
http://127.0.0.1:4141/ which cannot be accessed from another machine.
Kedro-Viz has a number of options to customise running the visualisation:
||TCP port that viz will listen to. Defaults to 4141.|
||Whether to open viz interface in the default browser or not.|
||Path to load the pipeline JSON file|
||Name of the modular pipeline to visualise. If not set, the default pipeline is visualised.|
||Kedro configuration environment. If not specified, catalog config in
||Directory to render the static site to|
||Whether or not to serve the site after creating. Defaults to True.|
You're Awesome for considering a contribution! Contributions are welcome, please check out the Contributing Guide for more information. Please be a positive member of the community and embrace feedback
This project is licensed under the MIT License - see the LICENSE file for details
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size kedro_static_viz-0.4.4-py3-none-any.whl (572.5 kB)||File type Wheel||Python version py3||Upload date||Hashes View|
|Filename, size kedro-static-viz-0.4.4.tar.gz (573.7 kB)||File type Source||Python version None||Upload date||Hashes View|
Hashes for kedro_static_viz-0.4.4-py3-none-any.whl