mirror of
https://github.com/kristoferssolo/solorice.git
synced 2025-10-21 20:10:34 +00:00
67 lines
2.5 KiB
Markdown
67 lines
2.5 KiB
Markdown
# Troubleshooting Jupyter issues in the Interactive Window or Notebook Editor
|
|
|
|
This document is intended to help troubleshoot problems with starting Jupyter in the Interactive Window or Notebook Editor.
|
|
|
|
---
|
|
|
|
## Jupyter Not Starting
|
|
|
|
This error can happen when
|
|
|
|
- Jupyter is out of date
|
|
- Jupyter is not installed
|
|
- You picked the wrong Python environment (one that doesn't have Jupyter installed).
|
|
|
|
### The first step is to verify you are running the Python environment that you have Jupyter installed into.
|
|
|
|
The first time that you start the Interactive Window or the Notebook Editor VS Code will attempt to locate a Python environment that has Jupyter installed in it and can start a notebook.
|
|
|
|
The first Python interpreter to check will be the one selected with the selection dropdown on the bottom left of the VS Code window:
|
|
|
|
|
|
|
|
Once a suitable interpreter with Jupyter has been located, VS Code will continue to use that interpreter for starting up Jupyter servers.
|
|
If no interpreters are found with Jupyter installed a popup message will ask if you would like to install Jupyter into the current interpreter.
|
|
|
|
|
|
|
|
If you would like to change from using the saved Python interpreter to a new interpreter for launching Jupyter just use the "Python: Select interpreter to start Jupyter server" VS Code command to change it.
|
|
|
|
### The second step is to check that jupyter isn't giving any errors on startup.
|
|
|
|
Run the following command from an environment that matches the Python you selected:
|
|
`python -m jupyter notebook --version`
|
|
|
|
If this command shows any warnings, you need to upgrade or fix the warnings to continue with this version of Python.
|
|
If this command says 'no module named jupyter', you need to install Jupyter.
|
|
|
|
### How to install Jupyter
|
|
|
|
You can do this in a number of different ways:
|
|
|
|
#### Anaconda
|
|
|
|
Anaconda is a popular Python distribution. It makes it super easy to get Jupyter up and running.
|
|
|
|
If you're already using Anaconda, follow these steps to get Jupyter
|
|
|
|
1. Start anaconda environment
|
|
1. Run 'conda install jupyter'
|
|
1. Restart VS Code
|
|
1. Pick the conda version of Python in the python selector
|
|
|
|
Otherwise you can install Anaconda and pick the default options
|
|
https://www.anaconda.com/download
|
|
|
|
#### Pip
|
|
|
|
You can also install Jupyter using pip.
|
|
|
|
1. python -m pip install --upgrade pip
|
|
1. python -m pip install jupyter -U --force-reinstall
|
|
1. Restart VS Code
|
|
1. Pick the Python environment you did the pip install in
|
|
|
|
For more information see
|
|
http://jupyter.org/install
|