Installation - Linux

This guide provides instructions on installing the Cozmo SDK for computers running with an Ubuntu Linux operating system.

Warning

The Cozmo SDK is tested and and supported on Ubuntu 14.04 and 16.04. Anki makes no guarantee the Cozmo SDK will work on other versions of Linux. If you wish to try the Cozmo SDK on versions of Linux other than Ubuntu 14.04 or 16.04, please ensure the following dependencies are installed:

Ubuntu 14.04

Python Installation

  1. Type the following into your Terminal window to install Python 3.5:

    sudo add-apt-repository ppa:deadsnakes
    sudo apt-get update
    sudo apt-get install python3.5 python3.5-tk
    
  2. Then, install and set up virtualenv:

    sudo apt-get install python-pip
    pip install virtualenv
    virtualenv -p python3.5 ~/cozmo-env
    
  3. Last, make sure to activate the virtualenv any time you use cozmo:

    source ~/cozmo-env/bin/activate
    

Note

You’ll need to activate the virtualenv before running any python or pip commands. Learn more about virtualenv here.

SDK Installation

To install the SDK, type the following into the Terminal window:

pip install 'cozmo[camera]'

Note that the [camera] option adds support for processing images from Cozmo’s camera.

SDK Upgrade

To upgrade the SDK from a previous install, enter this command:

pip install --upgrade cozmo

Ubuntu 16.04

Python Installation

  1. Type the following into your Terminal window to install Python:

    sudo apt-get update
    sudo apt-get install python3
    
  2. Then install pip by typing in the following into the Terminal window:

    sudo apt install python3-pip
    
  3. Last, install Tkinter:

    sudo apt-get install python3-pil.imagetk
    

SDK Installation

To install the SDK, type the following into the Terminal window:

pip3 install --user 'cozmo[camera]'

Note that the [camera] option adds support for processing images from Cozmo’s camera.

SDK Upgrade

To upgrade the SDK from a previous install, enter this command:

pip3 install --user --upgrade cozmo

Mobile Device Setup

  • iOS devices require usbmuxd in order to run the Cozmo SDK. Usbmuxd is required for the computer to communicate with the iOS device over a USB cable.
  • Android devices require installation of Android Debug Bridge (adb) in order to run the Cozmo SDK. This is required for the computer to communicate with the Android mobile device over a USB cable and runs automatically when required.

Troubleshooting

Please see the Troubleshooting section of the Initial Setup page for tips, or visit the Cozmo SDK Forums to ask questions, find solutions, or for general discussion.


Terms and Conditions and Privacy Policy

Click here to return to the Anki Developer website.