Infomap is a network clustering algorithm based on the Map equation.
For detailed documentation, see mapequation.org/infomap.
For a list of recent changes, see CHANGELOG.md in the source directory.
Infomap can be installed either from PyPI using
pip or by
compiling from source.
A pre-compiled version is available for macOS users.
Installing on other operating systems requires a
To install, run:
pip install infomap
To upgrade, run:
pip install --upgrade infomap
When the Python package is installed, an executable called
infomap (with lowercase i) is available from any directory.
To get started, read Infomap Python API.
There are currently two Docker images available on Docker Hub.
mapequation/infomap can be started with
docker run -it --rm \
-v `pwd`:/data \
You can also use the supplied docker-compose.yml:
docker-compose run --rm infomap
mapequation/infomap:notebook can be started with
docker run \
-v `pwd`:/home/jovyan/work \
-p 8888:8888 \
start.sh jupyter lab
Or similarly, using docker-compose:
docker-compose up notebook
Compiling from source¶
Installing Infomap from source requires a working
To download and compile the newest version from Github, clone the repository by running
git clone firstname.lastname@example.org:mapequation/infomap.git
This creates the binary
Infomap, run it using:
./Infomap [options] network_data destination
For a list of options, run:
Read the documentation to learn more about the different options.
To install it, run
npm install @mapequation/infomap
If you have any questions, suggestions or issues regarding the software, please add them to GitHub issues.
Infomap is released under a dual licence.
To give everyone maximum freedom to make use of Infomap and derivative works, we make the code open source under the GNU Affero General Public License version 3 or any later version (see LICENSE_AGPLv3.txt).
For a non-copyleft license, please contact us.