Troubleshooting
When the computer has other ideas
This page exists for the moments when something absolutely should have worked and very much did not. Most beginner problems are recoverable and usually belong to a few repeat patterns.
Python does not seem to exist
- Try
python --version, thenpython3 --version, thenpy --version. - Close and reopen the terminal after installation.
- If the command is still not found, the issue is often PATH-related rather than a total install failure.
python --version
python3 --version
py --version
A package installed, but import still fails
- Confirm the environment is activated.
- Run
python -c "import sys; print(sys.executable)". - Install the package again inside that same environment.
- If using Jupyter, confirm the notebook kernel matches the environment you expect.
python -c "import sys; print(sys.executable)"
python -m pip list
Jupyter is behaving strangely
- Restart the kernel.
- Run all cells from the top.
- Check whether a variable from an earlier run is still lingering in memory.
- If needed, build a fresh notebook with the smallest working example.
jupyter lab
# then inside Jupyter:
# Kernel -> Restart Kernel
# Run -> Run All Cells
napari or the plugin will not launch
- Confirm you are in the environment where napari was installed.
- Reinstall the plugin in that same environment.
- If the environment feels messy, create a fresh one rather than layering more fixes onto the old one.