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 >

API Key


An API key gives each visualization access to the GPU cluster. Please ask your adminstrator or email pygraphistry@graphistry.com 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='your.server.com:80')

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