Documentation

Install Infomap for Python, R, CLI, Docker, and TypeScript

For most researchers, the Python package is the best starting point: it installs both the Python API and the infomap command-line tool. Use R for analysis workflows, Docker for reproducible compute environments, or standalone binaries when you only need the executable.

Python 3.11+CLI includedmacOS / Linux / Windows

API documentation

Use these references once Infomap is installed in Python or R.

Recommended for research workflows

Python package

Python 3.11+macOSLinuxWindows

Start here for most research workflows. The package installs both the Python API and the infomap command-line tool.

pip install infomap

Upgrade an existing installation

pip install --upgrade infomap

Verify the installation

infomap -v
PyPI Python API reference

R package

Rr-universe

Use the R package when Infomap is part of an R analysis workflow. Pre-built binaries are published on r-universe.

install.packages("infomap", repos = c("https://mapequation.r-universe.dev", "https://cloud.r-project.org"))

Native CLI with Homebrew

macOSLinuxCLI

Use Homebrew when you want the native command-line tool without installing the Python package.

brew install mapequation/infomap/infomap

Tap and install separately

brew tap mapequation/infomap
brew install infomap

Upgrade with the normal Homebrew flow

brew upgrade infomap

Docker

Dockeramd64arm64

Use the container image for reproducible CLI runs in CI, teaching material, or shared compute environments.

docker run -it --rm -v "$(pwd)":/data ghcr.io/mapequation/infomap:latest [infomap arguments]

TypeScript package

TypeScriptNPM

Use the WebAssembly worker package to embed Infomap in browser, Node.js, and TypeScript applications.

npm install @mapequation/infomap

Standalone binaries

macOSLinuxWindowsOpenMP

Use a standalone binary when you only need the executable. OpenMP builds may be faster on larger networks but require OpenMP runtime libraries.

OpenMPWithout OpenMP
Windowsinfomap-win.zipinfomap-win-noomp.zip
macOSinfomap-mac.zipinfomap-mac-noomp.zip
Ubuntuinfomap-ubuntu.zipinfomap-ubuntu-noomp.zip

Build from source

gccclang

Build locally when you want to modify Infomap, inspect the implementation, or compile with custom flags. Requires a working gcc or clang toolchain.

git clone git@github.com:mapequation/infomap.git
cd infomap
make build-native

Build without OpenMP

make build-native OPENMP=0

Show available CLI options

./Infomap --help

Run Infomap

After installation, the command-line form is:

infomap [options] network_data destination

For example:

infomap network.net out
infomap --two-level --directed network.net out

List all available options with:

infomap --help

Read next

Input and output formats
MapEquation

A research framework for understanding flows on networks.

Software

InfomapApps & Notebooks

© 2008–2026 mapequation.org · Terms

martin.rosvall [at] umu.se · Made at Umeå University