Getting Help

Searching For Your Question

If you need help with Drake, please first review the documentation on this website for things such as installation, the C++ API, or Python bindings.

Please also briefly review Drake’s open and closed GitHub issues and StackOverflow posts tagged for Drake to see if your issue has been encountered by someone else before.

Asking Your Question

If you know your question is a bug or feature request, please post a GitHub issue.

Otherwise, if you are seeking assistance (e.g. tutorials or a brief example), please post a question on StackOverflow with the drake tag.

If you are actively developing with Drake and may need more active discussions than what StackOverflow and GitHub may offer, consider asking for access to the Drake Developers Slack Channel. To do so, please email Russ Tedrake for access. Please note that this access may not always be readily granted. (Note: If you are a Drake developer wanting to invite someone, it will be faster to grant them access if you invite them directly via Slack.)

If you wish to contribute a patch, please see how to submit a pull request.

Helpful Information

When reporting an issue, please consider providing the following information (examples in italics, helper command in monospace):

  • Operating system (Ubuntu 18.04, macOS Catalina)
  • Language (C++, Python)
    • C++ compiler (GCC 7.5.0, GCC 9.3.0, Clang 6.0.0)
    • Python version (Python 3.6.7)
    • Python distribution (apt, homebrew)
  • If building from source:
    • Build system (Bazel, CMake)
      • Bazel version (which bazel; bazel version)
      • Bazel C++ compiler (bazel run @drake//common:print_host_settings)
      • CMake version (which cmake; cmake --version)
      • CMake C++ compiler (cmake -LA <path_to_source_dir> | grep 'CMAKE_.*_COMPILER')
    • Git revision (git rev-parse --short HEAD)
    • Building Drake vs. downstream project (like drake_bazel_external, drake_cmake_external)
  • If using binary release:
    • Download URL
    • Contents of drake/share/doc/drake/VERSION.TXT
    • Building downstream project (drake_cmake_installed)
  • If using Binder or Google Colaboratory:
    • A version of your notebook that we can access. Please check this by re-visiting your URL in a private browsing window. (You can add notebooks to public GitHub Gists.)
    • The version of pydrake you are using. To obtain the version information it, please add the following code to a cell and execute it:

      !cat /opt/drake/share/doc/drake/VERSION.TXT

      The output should look something like YYYYMMDDHHMMSS <git-sha>.

Older Sources

Some information was previously on a mailing list. Please do not use these resources, as they are now inactive.