Need help with ndlib?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

191 Stars 53 Forks BSD 2-Clause "Simplified" License 635 Commits 21 Opened issues


Network Diffusion Library - (for NetworkX and iGraph)

Services available


Need anything else?

Contributors list

NDlib - Network Diffusion Library

pyversions Build Status Coverage Status Documentation Status Updates Language grade: Python DOI Downloads Downloads SBD++

NDlib logo

NDlib provides implementations of several spreading and opinion dynamics models.

The project documentation can be found on ReadTheDocs.

If you use

as support to your research consider citing:

G. Rossetti, L. Milli, S. Rinzivillo, A. Sirbu, D. Pedreschi, F. Giannotti. NDlib: a Python Library to Model and Analyze Diffusion Processes Over Complex Networks. Journal of Data Science and Analytics. 2017. DOI:0.1007/s41060-017-0086-6 (pre-print available on arXiv)

G. Rossetti, L. Milli, S. Rinzivillo, A. Sirbu, D. Pedreschi, F. Giannotti. "NDlib: Studying Network Diffusion Dynamics", IEEE International Conference on Data Science and Advanced Analytics, DSAA. 2017.

Promo Video



To install the library just download (or clone) the current project and copy the ndlib folder in the root of your application.

Alternatively use pip:

sudo pip install ndlib

Documentation, Tutorials and Online Environments

For examples, tutorials and a complete reference visit the project documentation website on ReadTheDocs.

If you would like to test

functionalities withouth installing anything on your machine consider using the preconfigured Jupyter Hub instances offered by SoBigData++.

Jupyter Notebook Tutorial

Interested in an extensive tutorial on NDlib? Check out the official Jupyter Notebooks!

NDlib Overview


Collaborate with us!

is an active project, any contribution is welcome!

If you like to include your model in NDlib (as well as in NDlib-REST) feel free to fork the project, open an issue and contact us.

How to contribute to this project?

Contributing is good, doing it correctly is better! Check out our rules, issue a proper pull request /bug report / feature request.

Do you want to be part of the NDlib community to discuss enhancements, desiderata, bug fix? Join us on Slack!

We are a welcoming community... just follow the Code of Conduct.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.