Using Debug Mode in Uvicorn Python Files in PyCharm


Debugging is an essential part of the development process. It allows developers to identify and fix issues in their code, leading to more efficient and robust applications. When working with Uvicorn, a lightning-fast ASGI server for Python web applications, it’s crucial to know how to leverage the debug mode to streamline the debugging process. In this blog post, we’ll explore how to use debug mode in Uvicorn Python files in PyCharm, a popular integrated development environment (IDE).


Before we dive into the details, ensure that you have the following prerequisites in place:

  1. Python and PyCharm: Make sure you have Python installed on your machine, along with the PyCharm IDE. You can download the latest versions from the official Python and JetBrains websites.
  2. Uvicorn: Install the Uvicorn server if it’s not already installed. You can do this using the pip package manager by running the command pip install uvicorn.

Step-by-Step Guide

Now, let’s go through the step-by-step process of using debug mode in Uvicorn Python files in PyCharm:

Step 1: Set Up the Project

Open your project in PyCharm, or create a new one if needed. Ensure that you have a Python file containing the Uvicorn server code you want to debug. If you don’t have such a file, create a new Python file and import the necessary dependencies.

Step 2: Install Dependencies

If you haven’t already installed Uvicorn, open the terminal within PyCharm and run the command pip install uvicorn to install it.

Step 3: Modify the Uvicorn Server Code

Locate the section of the code where the Uvicorn server is instantiated. This is typically the section that looks similar to the following:

if __name__ == "__main__":, host="", port=8000)

To enable debug mode, modify the code as follows:

import uvicorn

if __name__ == "__main__":, host="", port=8000, debug=True)

By adding debug=True as an argument to the function, we enable debug mode in Uvicorn.

Step 4: Set Breakpoints

Next, set breakpoints in your code where you want the debugger to stop. Breakpoints allow you to pause the execution of the program at specific locations and inspect the values of variables and the program’s state. To set a breakpoint, click on the left gutter of the code editor next to the line numbers. You can set multiple breakpoints if necessary.

Step 5: Start the Debugger

Once you’ve set the breakpoints, you can start the debugger. Click on the “Debug” button in the toolbar or go to the “Run” menu and choose the “Debug” option. This action will initiate the Uvicorn server in debug mode.

Step 6: Debugging Process

With the debugger running, the Uvicorn server will start in debug mode. Execution will pause at the breakpoints you set, allowing you to analyze the program’s behavior and inspect variables. You can use various debugging features provided by PyCharm, such as stepping through the code, evaluating expressions, and watching variables.

Step 7: Analyze and Fix Issues As the program execution pauses at breakpoints, you can examine the values of variables, step through the code line by line, and analyze the program’s behavior to identify any issues or bugs. Use the debugging features provided by PyCharm, such as the Variables pane, Console, and Watches, to gain insights into the state of your application and track any anomalies.

While in debug mode, you can take advantage of PyCharm’s powerful debugging tools, such as:

  1. Stepping: Step through the code line by line using the Step Over (F8), Step Into (F7), and Step Out (Shift+F8) buttons. This allows you to follow the flow of execution and understand how the program progresses.
  2. Variable Inspection: Inspect the values of variables at different points in the code. The Variables pane in PyCharm displays all the variables in the current scope, allowing you to examine their values and make informed decisions about the program’s behavior.
  3. Conditional Breakpoints: Set breakpoints with conditions to pause execution only when specific conditions are met. This can be helpful when you want to focus on a particular scenario or when you want to investigate a specific branch of code.
  4. Expression Evaluation: Use the Console in PyCharm to evaluate expressions and test hypotheses about the program’s behavior. You can execute Python statements and inspect variables interactively to gain a deeper understanding of your code.
  5. Watch Variables: Add variables to the Watches pane to monitor their values continuously during the debugging process. This helps you keep track of important variables and detect any unexpected changes.

Step 8: Fixing Issues As you analyze the behavior of your Uvicorn server in debug mode, you may encounter bugs or unexpected behavior. The insights gained from the debugger can help you identify the root cause of the problem more efficiently.

When you encounter an issue, use the debugger to examine the state of variables, step through the code to understand the flow, and evaluate expressions to pinpoint problematic areas. With this information, you can make the necessary changes to your code to fix the issue.


Debugging is a crucial aspect of software development, and knowing how to use debug mode in Uvicorn Python files in PyCharm can greatly enhance your debugging experience. By leveraging breakpoints, variable inspection, stepping, and other debugging features, you can gain valuable insights into your code’s behavior and quickly identify and resolve issues.

In this blog post, we walked through the step-by-step process of enabling debug mode in Uvicorn Python files, setting breakpoints, starting the debugger, and utilizing PyCharm’s debugging tools. By following these steps, you can effectively debug your Uvicorn server code, leading to more robust and reliable web applications.

Debugging is a skill that improves with practice, so don’t hesitate to experiment with different scenarios and explore PyCharm’s debugging capabilities. Happy debugging!


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s