Installation - macOS / OS X
This guide provides instructions on installing the Cozmo SDK for computers running with a macOS operating system.
Installation Videos
For your convenience, videos are provided showing the installation steps being followed on a macOS / OS X computer; one using an iOS device, and one using an Android device. There is also full text-based documentation below these.
Python Installation
Install Homebrew on your system according to the latest instructions. If you already had brew installed then update it by opening a Terminal window and typing in the following:
brew update
Once Homebrew is installed and updated, type the following into the Terminal window to install the latest version of Python 3:
brew install python3
SDK Installation
Important: In 2025 and later, the Cozmo SDK requires a local dependency named ``cozmoclad`` that is no longer available from PyPI.
You must install it manually before continuing.
Open Terminal, then run the following command to download
cozmoclad:curl -o cozmoclad-3.6.6-py3-none-any.whl https://raw.githubusercontent.com/DDLbots/cozmo-python-sdk/refs/heads/master/cozmoclad/cozmoclad-3.6.6-py3-none-any.whl
Then install it with pip:
pip3 install --user ./cozmoclad-3.6.6-py3-none-any.whl
Finally, install the SDK itself:
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, follow these steps:
Uninstall the old version of `cozmoclad` (if installed):
pip3 uninstall cozmoclad
Download the updated ``cozmoclad`` wheel:
curl -o cozmoclad-3.6.6-py3-none-any.whl https://raw.githubusercontent.com/DDLbots/cozmo-python-sdk/refs/heads/master/cozmoclad/cozmoclad-3.6.6-py3-none-any.whl
Reinstall ``cozmoclad``:
pip3 install --user ./cozmoclad-3.6.6-py3-none-any.whl
Upgrade the SDK itself:
pip3 install --user --upgrade cozmo
Mobile Device Setup
iOS devices do not require any special setup in order to run the Cozmo SDK on a macOS system.
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.