PyCharm 2021.2 Help

Manage projects hosted on GitHub

Check out a project (clone)

You can clone a repository that you want to contribute to directly from PyCharm and create a new project based on it.

  1. From the main menu, choose Git | Clone.

  2. In the Get from Version Control dialog, choose GitHub on the left.

  3. Specify the URL of the repository that you want to clone. You can select a repository from the list of all GitHub projects associated with your account and the organization that your account belongs to.

  4. In the Directory field, enter the path to the folder where your local Git repository will be created.

  5. Click Clone. If you want to create a project based on these sources, click Yes in the confirmation dialog. PyCharm will automatically set Git root mapping to the project root directory.

Share a project on GitHub

You can add a remote GitHub repository for a project you are developing locally, so that others can view it or contribute to it.

  1. Open the project you want to share.

  2. From the main menu, choose Git | GitHub | Share Project on GitHub.

    If you have already registered your GitHub account in PyCharm, connection will be established using these credentials.

    If you have not registered your account in PyCharm, the Login to GitHub dialog opens. Specify your access token or request a new one with your login and password.

  3. When connection to GitHub has been established, the Share Project on GitHub dialog opens. Specify the new repository name, the name of the remote , and enter a description of your project.

    You can select the Private option if you do not want to allow public access to your repository for other GitHub users.

  4. Click Share to initiate a new repository and upload project sources to it.

Jump to the GitHub version of a file

You can jump from PyCharm to the GitHub version of a file. PyCharm detects which branch is currently active as well as the latest revision of the file, and opens the GitHub copy of the selected file in the corresponding commit in your web browser. If you are opening the GitHub file version from the editor, the file will be also automatically scrolled to the current line.

  • Select a file in the editor or in the Project view, and choose Open on GitHub from the context menu or from the Ctrl+Shift+A popup. The remote version of the file will open in the browser.

    If the file points to more than one remote, you will be prompted to select the appropriate repository.

Last modified: 08 March 2021