Skip to main content

A Component Library for Dash aimed at facilitating network visualization in Python, wrapped around Cytoscape.js

Project description

Dash Cytoscape GitHub license PyPi Version


A Dash component library for creating interactive and customizable networks in Python, wrapped around Cytoscape.js.


Getting Started in Python


Make sure that dash and its dependent libraries are correctly installed:

pip install dash

If you want to install the latest versions, check out the Dash docs on installation.


Install the library using pip:

pip install dash-cytoscape

If you wish to use the CyLeaflet mapping extension, you must install the optional leaflet dependencies:

pip install dash-cytoscape[leaflet]

Create the following example inside an file:

import dash
import dash_cytoscape as cyto
from dash import html

app = dash.Dash(__name__)
app.layout = html.Div([
            {'data': {'id': 'one', 'label': 'Node 1'}, 'position': {'x': 50, 'y': 50}},
            {'data': {'id': 'two', 'label': 'Node 2'}, 'position': {'x': 200, 'y': 200}},
            {'data': {'source': 'one', 'target': 'two','label': 'Node 1 to 2'}}
        layout={'name': 'preset'}

if __name__ == '__main__':


External layouts

You can also add external layouts. Use the cyto.load_extra_layouts() function to get started:

import dash
import dash_cytoscape as cyto
from dash import html


app = dash.Dash(__name__)
app.layout = html.Div([

Calling cyto.load_extra_layouts() also enables generating SVG images.

Getting Started in R


install.packages(c("devtools", "dash"))


Install the library using devtools:


Create the following example inside an app.R file:


app <- Dash$new()

        id = 'cytoscape-two-nodes',
        layout = list('name' = 'preset'),
        style = list('width' = '100%', 'height' = '400px'),
        elements = list(
          list('data' = list('id' = 'one', 'label' = 'Node 1'), 'position' = list('x' = 75, 'y' = 75)),
          list('data' = list('id' = 'two', 'label' = 'Node 2'), 'position' = list('x' = 200, 'y' = 200)),
          list('data' = list('source' = 'one', 'target' = 'two'))



The Dash Cytoscape User Guide contains everything you need to know about the library. It contains useful examples, functioning code, and is fully interactive. You can also use the component reference for a complete and concise specification of the API.

To learn more about the core Dash components and how to use callbacks, view the Dash documentation.

For supplementary information about the underlying Javascript API, view the Cytoscape.js documentation.


Make sure that you have read and understood our code of conduct, then head over to CONTRIBUTING to get started.


Instructions on how to run tests are given in


Dash, Cytoscape.js and Dash Cytoscape are licensed under MIT. Please view LICENSE for more details.

Contact and Support

See for ways to get in touch.


Huge thanks to the Cytoscape Consortium and the Cytoscape.js team for their contribution in making such a complete API for creating interactive networks. This library would not have been possible without their massive work!

The Pull Request and Issue Templates were inspired from the scikit-learn project.


Dynamically expand elements

Code | Demo View usage-elements on Github

Interactively update stylesheet

Code | Demo View usage-stylesheet on Github

Automatically generate interactive phylogeny trees

Code | Demo View usage-phylogeny on Github

Create your own stylesheet

Code | Demo View usage-advanced on Github

Use event callbacks

Code | Demo View usage-events on Github

Use external layouts

Code View usage-elements-extra on Github

Use export graph as image

Code View usage-image-export on Github

Make graph responsive

Code View usage-responsive-graph on Github

For an extended gallery, visit the demos' readme.

Download files

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

Source Distribution

dash_cytoscape-1.0.0.tar.gz (4.0 MB view hashes)

Uploaded Source

Built Distribution

dash_cytoscape-1.0.0-py3-none-any.whl (4.0 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page