Skip to content

Using Debugger Tools

This section will detail the necessary configuration / setup required to run the debugger tool from your IDE of choice.

VS Code


  • In VSCode, open the Hummingbot folder as your current workspace.

  • Click on the Run and Debug icon in the left-hand pane or press CTRL + Shift + D.

  • Click on the blue link for create a launch.json file

  • Select "Python Debugger" and then "Python File"

  • A window will open up containing the initial launch.json code. Replace this code with the one provided below:

      "version": "0.2.0",
      "configurations": [
          "name": "Python: Hummingbot Application",
          "type": "python",
          "request": "launch",
          "program": "${workspaceRoot}/bin/",
          "console": "integratedTerminal"
  • Save the changes.

  • Press CTRL + Shift + P and select "Python Interpreter."

  • Make sure to select the Hummingbot conda environment.

By executing the Start Debugging command which can be found under the Run menu at the top or pressing the F5 key, the debugger will automatically attach itself to the Hummingbot process. The Hummingbot app will appear in the integratedTerminal. You may change this as desired.


In the video below, Abel of CoinAlpha has shown how to debug a Script using Pycharm IDE.

Additionally, for PyCharm, you want to set up the debug configurations, as seen in the screenshot below.


For debugging it is neccessary that Gevent compatible in Python Debugger settings is enabled. See Stackoverflow Q&A.


As of this writing, there is no way to add breakpoints/log points to any of the Cython code in VSCode or PyCharm.