3.3. Debugging With Visual Studio Code

3.3.1. Learning Objectives

In this tutorial, we will go over

  • Debugging a standalone python script

  • Attaching to the omni.kit.debug.vscode_debugger extension to debug a running instance of Isaac Sim

3.3.2. Standalone Python Scripts


Debugging standalone python scripts is only supported on Linux currently

  1. From the Isaac Sim App Selector click the “Open in Terminal” button, then execute the following command: code . This launches a new VS Code window and opens the current folder. You can also launch VS Code and open the folder.

  2. Let’s try debugging a simple script, open standalone_examples/api/omni.isaac.kit/hello_world.py and place a breakpoint.

  3. Select the “Run” icon from the toolbar on the left, and ensure “Current File” is selected from the configuration dropdown menu.

  4. Click “Start Debugging” or press F5 to launch the debugger. Pressing F10 will step line by line. You can mouse over to examine variable values.

  5. Stop the current debugging session and let’s try passing a command-line argument to our code in the “args” field of the .vscode/launch.json file. For example, here we change the default nucleus server

            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "env": {
                "EXP_PATH": "${workspaceFolder}/apps",
                "RESOURCE_NAME": "IsaacSim"
            "python": "${workspaceFolder}/kit/python/bin/python3",
            "envFile": "${workspaceFolder}/.vscode/.standalone_examples.env",
            "preLaunchTask": "setup_python_env",
            "args": ["--/persistent/isaac/asset_root/default=\"omniverse://my_server\""]
  6. Add the following lines to hello_world.py and place a breakpoint on the print(server_check) line.

        # The most basic usage for creating a simulation app
        kit = SimulationApp()
        import carb
        server_check = carb.settings.get_settings().get_as_string("/persistent/isaac/asset_root/default")
        for i in range(100):
        kit.close()  # Cleanup application
  7. After modifying and saving the launch.json, press F5 to launch the debugger.

  8. Verify that the variable contains the server set in the args in launch.json


3.3.3. Attaching the Debugger to a Running App

To debug a script you are already running, use the VS Code Debugger extension.

  1. Launch Isaac Sim, and from the top toolbar, select Window > Extensions. Then search for “vscode” and click the Enable button for the omni.kit.debug.vscode extension. By default, the status will show “VS Code Debugger Unattached” in red text.

  2. Then launch VS Code, and select the “Run” icon from the toolbar on the left.

  3. From the configuration menu, select “Python: Attach (windows-x86_64/linux-x86_64) and click the green arrow to start debugging.

  4. Notice that the status in Isaac Sim changes to “VS Code Debugger Attached” in blue text.

  5. You can now return to your python file in VS Code and add breakpoints to debug, as described above.


To configure the host and port used for debugging, the following command-line arguments can be provided


These should match the configuration in your vscode launch.json

:emphasize-lines: 5,6
        "name": "Python: Attach (windows-x86_64/linux-x86_64)",
        "type": "python",
        "request": "attach",
        "port": 3000,
        "host": ""

3.3.4. Summary

In this tutorial, we covered #. Debugging a standalone python script #. Attaching the vscode debugger to a running instance of Isaac Sim Further Learning

For more details about how the vscode integration works, refer to Visual Studio Code (VSCode) Support