English
Neu.ro Core
Neu.ro Toolbox
ADMINISTRATION
Remote Debugging with PyCharm Professional
Introduction
In this tutorial, you can learn how to set up remote debugging with PyCharm Professional on the Neuro Platform using the Neu.ro project template.
Initializing a new project
1
$ pipx install neuro-all cookiecutter
2
$ neuro login
Copied!
Then, initialize an empty project:
1
$ cookiecutter gh:neuro-inc/cookiecutter-neuro-project --checkout release
Copied!
This command will prompt you to enter some info about your project:
1
project_name [Name of the project]: Neuro PyCharm
2
project_dir [neuro pycharm]:
3
project_id [neuro_pycharm]:
4
code_directory [modules]:
5
preserve Neuro Flow template hints [yes]:
Copied!
Next, switch to the new project's folder and configure the project's environment on the Neuro Platform:
1
$ cd neuro pycharm
2
$ neuro-flow build train
Copied!
Setting up PyCharm
Open the project you have just created in PyCharm Professional and add the code you want to debug as a new
main.py file (in this example, we use a code snippet from the JetBrains documentation).Then, you will need to exclude all directories that don't contain Python code (in an empty Neu.ro project, only the
modules folder will contain code). PyCharm doesn't synchronize excluded directories. Select all directories to exclude, right-click, and select Mark Directory as -> Excluded. As a result, you will see a configured project:
Run these commands to upload your code to the Neuro Platform storage:
1
> neuro-flow mkvolumes
2
> neuro-flow upload ALL
Copied!
Now, we are ready to start a GPU-powered development job on the Neuro Platform. Run the following command:
1
> neuro-flow run remote_debug
Copied!
This command starts a
remote_debug job on the Neuro Platform. This job uses the cluster's default preset and forwards the local port 2211 to the job's SSH port. All running jobs consume your quota, so please don't forget to terminate your jobs when they are no longer needed. You can use neuro-flow kill remote_debug to kill the job you created in the previous step or neuro-flow kill ALL to kill all your running jobs.Then go back to the PyCharm project and navigate to Preferences -> Project -> Project interpreter (you can also search for "interpreter"). Click the gear icon to view the project interpreter options and select Add... In the new window, select SSH Interpreter and set up the following configuration:
- Host: localhost
- Port: 2211
- Username: root
When this is done, click Next.
In the new window, specify the paths for the interpreter and synced folders:
1
Interpreter: /usr/bin/python
2
Sync folders: <Project root> -> /neuro pycharm
Copied!
Note that, within the job, your project's root folder is available at the root of the filesystem:
/{project_name} . Click Finish, and your configuration is ready:
Click OK.
Once you apply the remote interpreter configuration, PyCharm will start file synchronization.
Your PyCharm project is now configured to work with a remote Python interpreter running in a Neu.ro job.
Debugging
In this example, we're working with the
main.py file. To enter debug mode, right-click the file and click Debug 'main':
Now, you can interact with the file in debug mode:
If your project's mapping was not configured and the remote interpreter attempts to execute a file with a local path on the remote environment, you might need to specify the path mappings. You can do that at Run -> Edit Configurations... -> Path mappings:
Last modified 1mo ago
Copy link