Pythons: Python 3.4, 3.5, 3.6, 3.7, 3.8, PyPy3

Platforms: Unix/Posix and Windows

On Windows, make sure you add Python in the Path from System Variables:

  • C:\Python<version>\ (e.g., C:\Python37)

  • C:\Python<version>\Scripts (e.g., C:\Python37\Scripts\)

And in the Path from User Variables:

  • C:\Users\\AppData\Local\Programs\Python\Python<version>\Scripts



AltWalker relies on Graphwalker to generate paths through your model(s).

AltWalker uses the GraphWalker CLI, the CLI is a standalone jar file. You need to have Java 8 installed to be able to execute the jar file.

You need to download GraphWalker CLI from GitHub Releases and create a script to run the jar file from the command line. We recommend downloading the latest version of GraphWalker CLI.

To install GraphWalker you can run the following command:

$ wget && \
  mkdir -p ~/graphwalker && \
  mv graphwalker-cli-4.2.0.jar ~/graphwalker/ && \
  echo -e '#!/bin/bash\njava -jar ~/graphwalker/graphwalker-cli-4.2.0.jar "$@"' > ~/graphwalker/ && \
  chmod +x ~/graphwalker/ && \
  ln -s ~/graphwalker/ /usr/local/bin/gw

Here is a more detailed tutorial for macOS/linux.

$ setx PATH "%PATH%;C:\graphwalker" & :: Adds graphwalker to current user PATH
  cd C:\
  mkdir graphwalker
  cd graphwalker
  powershell -Command "[Net.ServicePointManager]::SecurityProtocol = 'tls12'; Invoke-WebRequest -Uri '' -outfile 'graphwalker-cli-4.2.0.jar'" & :: Downloads graphwalker using powershell command Invoke-Request
  @echo off
  @echo @echo off> gw.bat
  @echo java -jar C:\graphwalker\graphwalker-cli-4.2.0.jar %*>> gw.bat
  @echo on

After installing GraphWalker check that you installed the correct version:

$ gw --version
org.graphwalker version: 4.2.0-9395540

org.graphwalker is open source software licensed under MIT license
The software (and it's source) can be downloaded from
For a complete list of this package software dependencies, see

Currently the latest version is:

org.graphwalker version: 4.2.0-9395540

Install altwalker

To install altwalker run the following command in your command line:

$ pip3 install altwalker


$ python<version> -m pip install altwalker

Check that you installed the correct version:

$ altwalker --version
AltWalker, version 0.2.7

Living on the edge

If you want to work with the latest code before it’s released, install or update the code from the develop branch:

$ pip3 install -U git+

Install .NET Core (Optional)

.NET Core is required by AltWalker when you want to write your tests in a .NET supported language.

  • Install .NET Core Runtime - enables AltWalker to execute compiled tests. Preferred in production environment.

  • Install .NET Core SDK - enables AltWalker to use dotnet to compile and run your tests. Preferred in development environment.

The dotnet command needs to be available under /usr/bin/dotnet. Installing .NET Core with snap makes the dotnet command available under a different path. In this case create a symbolic link:

$ ln -s /path/to/dotnet /usr/bin/dotnet