Documentation
For most users, the Python package is the best starting point: it installs both the Python API and the infomap command-line tool. If you only need a native CLI, use Homebrew or a standalone binary.
Use this if you want the Python API or the easiest way to install the infomap command-line tool.
pip install infomap
Upgrade an existing installation
pip install --upgrade infomap
Verify the installation
infomap -v
Use Homebrew if 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
Use a standalone binary when you want to download an executable directly. OpenMP builds may be faster on larger networks but require OpenMP runtime libraries.
| OpenMP | Without OpenMP | |
|---|---|---|
| Windows | infomap-win.zip | infomap-win-noomp.zip |
| macOS | infomap-mac.zip | infomap-mac-noomp.zip |
| Ubuntu | infomap-ubuntu.zip | infomap-ubuntu-noomp.zip |
Pre-built R binaries are published on r-universe.
install.packages("infomap", repos = c("https://mapequation.r-universe.dev", "https://cloud.r-project.org"))Use the WebAssembly worker package to embed Infomap in browser and TypeScript applications.
npm install @mapequation/infomap
Use the GitHub Container Registry image for reproducible CLI runs in CI or shared compute environments.
docker run -it --rm -v "$(pwd)":/data ghcr.io/mapequation/infomap:latest [infomap arguments]
Build locally when you want to modify Infomap 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
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