Table Of Contents

Previous topic

PyGraphviz documentation

Next topic



Quick Install

Get PyGraphviz from the Python Package Index at

or install it with:

easy_install pygraphviz

and an attempt will be made to find and install an appropriate version that matches your operating system and Python version.

More download options are at

Installing from Source

You can install from source by downloading a source archive file (tar.gz or zip) or by checking out the source files from the Subversion repository.

Source Archive File

  1. Download the source (tar.gz or zip file).
  2. Unpack and change directory to pygraphviz-“version”
  3. Run “python install” to build and install
  4. (optional) Run “python nosetests” to execute the tests

SVN Repository

  1. Check out the PyGraphviz trunk:

    svn co pygraphviz
  2. Change directory to “pygraphviz”

  3. Run “python install” to build and install

  4. (optional) Run “python nosetests” to execute the tests

If you don’t have permission to install software on your system, you can install into another directory using the –prefix or –home flags to

For example

python install --prefix=/home/username/python
python install --home=~

If you didn’t install in the standard Python site-packages directory you will need to set your PYTHONPATH variable to the alternate location. See for further details.



To use PyGraphviz you need GraphViz version 2.16 or later. Some versions have known bugs that have been fixed; get the latest release available for best results.


To use PyGraphviz you need Python version 2.4 or later

The easiest way to get Python and most optional packages is to install the Enthought Python distribution

Other options are



OSX 10.5 ships with Python version 2.5. If you have an older version we encourage you to download a newer release. Pre-built Python packages are available from

If you are using Fink or MacPorts, Python is available through both of those package systems.


Python is included in all major Linux distributions