1. Setup the Cozmo SDK.
  1. Clone the repository.
$ git clone
  1. Navigate to the repository.
$ cd cozmo-song-match
  1. Install dependencies.
$ pip install -r requirements.txt


We recommend installing dependencies within a virtual environment. See Virtual Environments for details.

  1. With Cozmo connected, run the main program. For details on connecting Cozmo, see Getting Started With the Cozmo SDK.
$ python

We support command line arguments for configuring what song you want to play, and how many players. Use the help flag -h for help.

$ python -h

usage: [-h] [-s S] [-p N]

Play Song Match with Cozmo.

optional arguments:
  -h, --help  show this help message and exit
  -s S        The song to play. Hot Cross Buns (hcb), Mary Had A Little Lamb
              (mhall), or Rain Rain Go Away (rrga). Defaults to a random song.
  -p N        The number of players for the game. Defaults to None. If None
              then selecting the number of players will be handled in game.
  1. Download and Install PyCharm (Optional)