Skip to content

Instructions to Connect VSCode to JupyterLab Kernel from UC AF

You can follow these steps to connect your Visual Studio Code to a JupyterLab kernel that is running on the University of Chicago Analysis Facility (UC AF). This allows you to work on your Jupyter notebooks using VS Code while utilizing the computational resources of UC AF.

Steps

  1. Access Your JupyterLab:
  2. Visit UC AF JupyterLab to access your JupyterLab environment.
  3. You'll need to log in with your credentials and create your Jupyter server.

  4. Get the JupyterLab URL:

  5. Right click on the link to your JupyterLab instance, then copy it. This link typically looks like https://ivukotic-notebook-1.notebook.af.uchicago.edu/?token=....

  6. Configure VS Code:

  7. Open Visual Studio Code.
  8. Install the Python and Jupyter extensions if you haven't already.

  9. Select Your Server and Kernel:

  10. Open the notebook file you wish to work on in VS Code.
  11. Click on the kernel picker in the top right corner of the notebook editor
  12. Click the kernel dropdown → click "Select Another Kernel..." → then "Existing Jupyter Server...".
  13. Paste your server URI there.
  14. Select the kernel you want to use from your JupyterLab.

  15. Using the Remote Kernel:

  16. Once the correct Kernel is selected, you can execute your notebook code within VS Code, utilizing the UC AF's computational resources.
  17. If you encounter issues, ensure that VS Code is allowed through your firewall if applicable, and your network allows communicating with the UC AF nodes.

Enjoy coding with the power of UC AF directly from VS Code!

Notes

  • Make sure your JupyterLab instance is running and remains active while you are using VS Code to connect.