Notebook Setup

In this tutorial, we're going to use the PyGraphistry python library to create and visualize our first graph, then move on to more advanced techniques like creating a graph from any CSV, modifying visualization properties, and analyzing data from within the Graphistry visual environment.

Installing Graphistry locally with Docker

Visualize our first graph using a Jupyter notebook

Learn about hypergraphs and upload any CSV to Graphistry

Discover all the tools available within our visualization

Section 1. Installing PyGraphistry

There are 2 easy ways to get up and running quickly

Option 1:

Direct install from Python's pip package manager: Great for existing Python or Jupyter Notebook users

Depends on
Python 2.7 or 3.4 (experimental).

1. If you already have Python, install IPython (Jupyter):

pip install "ipython[notebook]"

2. Launch notebook server:

ipython notebook

3. Install PyGraphistry:

With Pandas only:

pip install graphistry

With Pandas, IGraph, and NetworkX:

pip install "graphistry[all]"

Option 2:

Install from a premade Docker container with PyGraphistry, Jupyter Notebook,
and Scipy/numpy/pandas

1. Install Docker

2. Install and run the Jupyter Notebook + Graphistry container:

docker run -it --rm -p 8888:8888 graphistry/jupyter-notebook

If you would like to open data in the current folder $PWD or save results to the current folder $PWD, instead run:

docker run -it --rm -p 8888:8888 -v "$PWD":/home/jovyan/work/myPWDFolder graphistry/jupyter-notebook

3. After you run the above command, you will be provided a link. Go to it in a web browser:

http://localhost:8888/?token=< generated token value >


An API key gives each visualization access to the GPU cluster. Please ask your adminstrator or email for a key. Set your key after the import graphistry statement and you are good to go:

import graphistry
graphistry.register(key='Your key')
#graphistry.register(key='Your key', protocol='http', server='')

Optionally, for convenience, you may set your API key in your system environment and thereby skip the register step in all your notebooks. In your .profile or .bash_profile, add the following, reload your environment, and restart your notebook server:

export GRAPHISTRY_API_KEY="Your key"

Next: Visualizing Existing Graphs