Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

A Python implementation of a edges, vertices, and graphs

Project description Documentation Status

A Python implementation of edges, vertices, and graphs


There are two types of each object: Undirected and Directed.

To begin, import one of the graph classes:

from graphpy.graph import UndirectedGraph

and create a graph from a dictionary of vertex vals:

# graph with vertices 'v0' and 'v1', with an edge between them

g = UndirectedGraph.from_dict({'v0': [('v1',)],
                               'v1': []})

or from a list of vertices and a list of edges:

g = UndirectedGraph.from_lists([('v0',), ('v1',)],
                               [('v0', 'v1')])

You can also initialize a graph, then add vertices and edges:

g = UndirectedGraph()

g.add_edge(('v0', 'v1'))

A vertex’s val can be any hashable object, like a string, int, tuple, etc.:

# graph with vertices 'v0', 1, and (2, 2), with some edges

g = UndirectedGraph.from_dict({'v0': [(1,)],
                               1: [('v0',), ((2, 2),)],
                               (2, 2): [(1,)]})

Retrieve vertex and edge objects:

# v is an UndirectedVertex object, and e is an UndirectedEdge object

v = g.get_vertex('v0')

e = g.get_edge(('v0', 'v1'))
print e.vertices

Iterate through a graph’s vertices:

for v in g:
    print v

Perform graph algorithms, such as search:

paths ='v0', method='depth_first')
print paths

Create graphs with vertices and edges that have whatever attributes you want (for example, edge weights):

g = UndirectedGraph.from_lists([('v0', {'city': 'Paris'}), ('v1', {'city': 'London'})],
                               [('v0', 'v1', {'weight': 5})])

>From there, use graphs to model situations, implement more graph algorithms, and whatever else you desire. And, as always, have fun!

(The tests found on Github at give many more examples and showcase the rest of the library’s functionality.)


Find the full documentation at:


If you don’t have pip, get pip at:

Run the command pip install graphpy in your terminal to get the graphpy library.

To test your installation, start a Python interpreter with the python command in your terminal and make sure you can run import graphpy in it without getting an error.


Find the code on Github at:


Contact me (Tyler Singer-Clark) at with any questions or concerns.


The project is licensed under the MIT license.

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
graphpy-1.1.0-py2-none-any.whl (21.0 kB) Copy SHA256 hash SHA256 Wheel py2 Nov 10, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page