@quantumblack/kedro-viz

    4.0.0 • Public • Published

    Kedro-Viz


    Kedro-Viz Pipeline Visualisation

    Data Science Pipelines. Beautifully Designed
    Live Demo: https://quantumblacklabs.github.io/kedro-viz/


    CircleCI npm version Python Version PyPI version License DOI code style: prettier

    Introduction

    Kedro-Viz is an interactive development tool for building data science pipelines with Kedro.

    Features

    • Complete visualisation of a Kedro project and its pipelines
    • 🎨 Supports light & dark themes out of the box
    • 🚀 Scales to big pipelines with hundreds of nodes
    • 🔎 Highly interactive, filterable and searchable
    • 🔬 Focus mode for modular pipeline visualisation
    • 📊 Rich metadata side panel to display parameters, plots, etc.
    • ♻️ Autoreload on code change
    • 🎩 Many more to come

    Installation

    There are two ways you can use Kedro-Viz:

    • As a Kedro plugin (the most common way).

      To install Kedro-Viz as a Kedro plugin:

      pip install kedro-viz
    • As a standalone React component (for embedding Kedro-Viz in your web application).

      To install the standalone React component:

      npm install @quantumblack/kedro-viz

    Usage

    As a Kedro plugin

    To launch Kedro-Viz from the command line as a Kedro plugin, use the following command from the root folder of your Kedro project:

    kedro viz

    A browser tab opens automatically to serve the visualisation at http://127.0.0.1:4141/.

    Kedro-Viz also supports the following additional arguments on the command line:

    Usage: kedro viz [OPTIONS]
    
      Visualise a Kedro pipeline using Kedro-Viz.
    
    Options:
      --host TEXT               Host that viz will listen to. Defaults to
                                localhost.
    
      --port INTEGER            TCP port that viz will listen to. Defaults to
                                4141.
    
      --browser / --no-browser  Whether to open viz interface in the default
                                browser or not. Browser will only be opened if
                                host is localhost. Defaults to True.
    
      --load-file FILE          Path to load the pipeline JSON file
      --save-file FILE          Path to save the pipeline JSON file
      --pipeline TEXT           Name of the registered pipeline to visualise. If not
                                set, the default pipeline is visualised
    
      -e, --env TEXT            Kedro configuration environment. If not specified,
                                catalog config in `local` will be used
    
      --autoreload              Autoreload viz server when a Python or YAML file change in
                                the Kedro project
    
      -h, --help                Show this message and exit.

    As a standalone React component

    To use Kedro-Viz as a standalone React component, import the component and supply a data JSON as prop:

    import KedroViz from '@quantumblack/kedro-viz';
    
    const MyApp = () => <KedroViz data={json} />;

    The JSON can be obtained by running:

    kedro viz --save-file=filename.json

    Feature Flags

    Kedro-Viz uses features flags to roll out some experimental features. The following flags are currently in use:

    Flag Description
    sizewarning From release v3.9.1. Show a warning before rendering very large graphs (default true)

    To enable or disable a flag, click on the settings icon in the toolbar and toggle the flag on/off.

    Kedro-Viz also logs a message in your browser's developer console to show the available flags and their values as currently set on your machine.

    Maintainers

    Kedro-Viz is maintained by the product team from QuantumBlack and a number of contributors from across the world.

    Contribution

    If you want to contribute to Kedro-Viz, please check out our contributing guide.

    License

    Kedro-Viz is licensed under the Apache 2.0 License.

    Citation

    If you're an academic, Kedro-Viz can also help you, for example, as a tool to visualise how your publication's pipeline is structured. Find our citation reference on Zenodo.

    Keywords

    none

    Install

    npm i @quantumblack/kedro-viz

    Homepage

    .

    DownloadsWeekly Downloads

    20

    Version

    4.0.0

    License

    none

    Unpacked Size

    892 kB

    Total Files

    158

    Last publish

    Collaborators

    • richardwestenra
    • ottis_qb
    • msammons99
    • leonnallamuthu
    • limdauto
    • studioswong