How to Configure Odoo 15 in PyCharm A Step-by-Step Guide


Odoo is a powerful and versatile open-source ERP (Enterprise Resource Planning) system that allows businesses to manage various aspects of their operations, including sales, inventory, accounting, and more. PyCharm, on the other hand, is a popular integrated development environment (IDE) for Python developers. Combining the capabilities of both Odoo and PyCharm can greatly enhance your development and customization experience. In this blog post, we’ll walk you through the process of configuring Odoo 15 in PyCharm for efficient development and customization.


  • Python 3.7 or later
  • PyCharm (Community or Professional edition)
  • Odoo 15 source code

Step 1: Install PyCharm

If you haven’t already installed PyCharm, you can download it from the official website (https://www.jetbrains.com/pycharm/download/). Follow the installation instructions for your operating system, and make sure to launch PyCharm after installation.

Step 2: Set Up a Virtual Environment

Creating a virtual environment is a best practice in Python development to isolate your project’s dependencies. Here’s how to create one

  1. Open PyCharm.
  2. Go to “File” > “New Project…”
  3. In the “New Project” dialog, choose a location for your project.
  4. Select “Existing Interpreter” and click on the gear icon to the right.
  5. Choose “Add…”
  6. In the “Add Python Interpreter” dialog, select “Virtualenv Environment” and click “OK.”
  7. Specify the location for your virtual environment and choose the Python interpreter (3.7 or later).
  8. Click “Create.”

Step 3: Clone the Odoo 15 Repository

To work with Odoo 15 in PyCharm, you need to clone the Odoo source code from its official repository on GitHub.

  1. Open a terminal within PyCharm by clicking “View” > “Tool Windows” > “Terminal.”
  2. Navigate to the directory where you want to clone the Odoo repository.
  3. Run the following command to clone the repository
git clone https://www.github.com/odoo/odoo --depth 1 --branch 15.0 --single-branch .

Step 4: Configure Odoo 15 in PyCharm

Now that you have the Odoo source code and a virtual environment set up, it’s time to configure PyCharm to work with Odoo.

  1. In PyCharm, open your project folder (the one containing the cloned Odoo repository).
  2. Go to “File” > “Settings” (or “PyCharm” > “Preferences” on macOS).
  3. In the left sidebar, navigate to “Project: YourProjectName” > “Python Interpreter.”
  4. Click the gear icon at the top-right corner and select “Add.”
  5. Choose “System Interpreter” and select the Python interpreter from your virtual environment created earlier.
  6. Click “OK” to save the interpreter settings.

Step 5: Install Odoo Dependencies

Odoo has several Python dependencies that you need to install in your virtual environment. You can install them using the following command:

pip install -r requirements.txt

Make sure you run this command in the terminal within PyCharm.

Step 6: Create an Odoo Configuration File

Create a configuration file for your Odoo instance. You can copy the provided odoo.conf from the Odoo source code and customize it to suit your needs. Place the configuration file in the Odoo source code directory.

Step 7: Run Odoo in PyCharm

To run Odoo from PyCharm, you’ll need to configure a Python run configuration:

  1. In PyCharm, go to “Run” > “Edit Configurations…”
  2. Click the “+” button to create a new configuration and select “Python.”
  3. Configure the following settings:
  • Name: Enter a name for your configuration.
  • Script Path: Browse and select the odoo-bin file in your Odoo source code directory.
  • Parameters: -c /path/to/your/odoo.conf
  • Working Directory: Set it to your Odoo source code directory.
  1. Click “OK” to save the configuration.

Now, you can run Odoo by selecting your newly created configuration and clicking the “Run” button.


Configuring Odoo 15 in PyCharm can greatly improve your development workflow, making it easier to customize and extend Odoo for your business needs. By following the steps outlined in this guide, you’ll be well on your way to developing and customizing Odoo with the powerful tools and features offered by PyCharm. Happy coding!

Related Articles

Leave a Reply

Your email address will not be published. Required fields are marked *

Back to top button