Previewing

Before installing, you can preview Drake online using our interactive Python notebooks. See the Tutorials page for details.

Installation

Supported Configurations

The following table shows the configurations and platforms that Drake officially supports:

“Official support” means that we have Continuous Integration test coverage to notice regressions, so if it doesn’t work for you then please file a bug report.

Unofficially, Drake is also likely to be compatible with newer versions of Ubuntu or macOS than what are listed, or with Ubuntu 22.04 running on arm64, or with other versions of Python. However, these are not supported so if it doesn’t work for you then please file a pull request with the fix, not a bug report.

⁽¹⁾ Drake features that perform image rendering (e.g., camera simulation) require a working display server. Most personal computers will have this already built in, but some cloud or docker environments may require extra setup steps.

⁽²⁾ CPython is the only Python implementation supported. Drake is not tested regularly with Anaconda, so if you are using Anaconda you may experience compatibility hiccups; when asking for help, be sure to mention that Conda is involved.

⁽³⁾ The Python version shown in the table is supported for all installation channels. Additionally, when installing via pip on Ubuntu Python versions 3.10 through 3.12 (inclusive) are supported and on macOS Python versions 3.11 through 3.12 (inclusive) are supported. Refer to OS Support for details on our “end of life” timeline for changing which Python versions are supported.

⁽⁴⁾ These end-of-life dates are estimates. Refer to OS Support for details.

⁽⁵⁾ We aim to support Ubuntu 24.04 within two months of its release.

⁽⁶⁾ For the stable release pip wheel builds only, we also support the x86_64 architecture for macOS.

Additionally, if you are compiling your own C++ code against Drake’s C++ code and are using Drake’s pre-compiled binaries, then you must use the same compiler as our releases:

Available Versions

Drake publishes stable releases approximately once a month, and also offers nightly builds on an ongoing basis.

For new users, we recommend using the stable releases. New releases will be announced on Drake’s GitHub releases page and documented in Drake’s Release Notes. Refer to our Drake Stability Guidelines for our policy on API changes.

Experienced users who want access to the latest features may use the nightly builds.

Choose an Installation Method

The following table shows the installation methods available for Drake’s pre-compiled binaries, per the supported platforms and release versions.

The pip packages only support using Drake via Python. All other packages support both C++ and/or Python.

Alternatively, you can skip the pre-compiled binaries and build Drake following the instructions in Source Installation.

Drake’s binary releases do not support the Gurobi solver. To use Gurobi, you must build Drake from source.

We’re considering adding macOS support for Homebrew, i.e., brew install drake. Please upvote or comment on #12782 if you are interested.

Quickstart

For Python, refer to Using the Python Bindings.

For C++, refer to either the example CMake project for apt (deb) or the example CMake project for tar.gz download.