How to Download and Install Cogment


Please install:

  1. Docker and docker-compose

  2. protoc

Install the latest Cogment CLI

The latest cogment CLI is available here as an executable binary.

Choose the appropriate file for your system, rename the file to "cogment", and make sure to put it in a folder that is in your 'PATH' environmental variable.

With a working installation you can run the following in a terminal:

$ cogment version

You can then list all the commands by typing:

$ cogment help

or for help on each individual command:

$ cogment help <command>

Test your installation

In order to test that your installation is fully working, run an existing Cogment app, for example one of the steps of the tutorial.

Download or clone the sources for the official Rock-Paper-Scissors (RPS) tutorial from

Once it is done, run the following in the directory you retrieved:

$ cd 5-human-player
$ cogment run generate
$ cogment run build
$ cogment run start

The first cogment command will run the code generation phase for this project. If everything runs fine it means cogment and Protobuf's protoc are installed correctly.

The second will build docker images for the services of this Cogment app. If everything runs fine it means the docker and docker-compose installations are functional.

Finally, the third command will start the Cogment app. In another terminal you can connect to it and play a few games of RPS against a simple AI agent.

$ cogment run client

Congratulations, you have a working installation of Cogment! We recommend you head to the Cogment tutorial to learn how to implement this RPS app from scratch.