Create a Django project

Create a new Django project

1. From the main menu, choose File | New Project, or click the New Project button in the Welcome screen. New Project dialog opens.

   

2. In the New Project dialog, do the following:

   • Specify project type Django.

   • Specify project location.

   • New environment using: if this option has been selected, choose the tool to be used to create a virtual environment. To do that, click the list and choose Virtualenv, Pipenv, Poetry, or Conda.

     Next, specify the Location and Base interpreter of the new virtual environment.

     Select the Inherit global site-packages checkbox if you want that all packages installed in the global Python on your machine to be added to the virtual environment you're going to create. This checkbox corresponds to the --system-site-packages option of the virtualenv tool.

     Select the Make available to all projects checkbox if you want to reuse this environment when creating Python interpreters in PyCharm.

     When configuring the base interpreter, you need to specify the path to the Python executable. If PyCharm detects no Python on your machine, it provides the following options:

     • Specify a path to the Python executable (in case of non-standard installation)

     • Download and install the latest Python versions from python.org

     • Install Python using the Command-Line Developer Tools (macOS only).

     Windows

     macOS

     

     

   • Previously configured interpreter: if this option has been selected, choose the desired interpreter from the list, or (if the desired interpreter is not found), click Add Interpreter and choose the interpreter. See Configure a Python interpreter for details.

     note

     When PyCharm stops supporting any of the outdated Python versions, the corresponding Python interpreter is marked as unsupported.

     

3. Click (More Settings), and specify the following:

   • From the Template language list, select the language to be used.

   • In the Templates folder field, specify the directory where the templates will be stored, and where they will be loaded from. You can specify the name of the directory that doesn't yet exist; in this case, the directory will be created.

   • In the Application name field, type the name of the Django application to be created.

     note

     The name of a Django application should not be the same as the Django project name.

   • If you need admin interface to be created, select the Enable Django admin checkbox.

   tip

   If Django is missing in the selected interpreter, PyCharm displays an information message that Django will be downloaded.

4. Click Create.