Skip to content

Commit 5175844

Browse files
committed
README.notebooks: add more tips
1 parent 624aa6d commit 5175844

File tree

1 file changed

+11
-4
lines changed

1 file changed

+11
-4
lines changed

README.notebooks.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,15 @@
22

33
Here are some tips on using `pybricksdev` with Jupyter notebooks.
44

5-
- Create a virtual environment for hosting the kernel.
6-
- Required packages: `pybricksdev`, `notebook`, `ipykernel`, `ipywidgets`
7-
- Enable widgets for progress bars: `jupyter nbextension enable --py widgetsnbextension`
5+
- Create a virtual environment for hosting the kernel (remember `pybricksdev` is Python 3.8 only!).
6+
- Use `apt`, `brew`, `pipx`, etc. and not `pip` for installing notebook server globally.
7+
- Required packages for kernel: `pybricksdev`, `ipykernel`, `ipywidgets`
8+
- Recommended packages for kernel: `matplotlib`
89
- Create a named kernel: `python -m ipykernel install --user --name=pybricksdev`
9-
- Start a notebook server: `jupyter notebook`
10+
- Required packages for notebook server (classic): `notebook`, `widgetsnbextension`
11+
- Required packages for notebook server (new): `jupyterlab`, `jupyterlab_widgets`
12+
- Enable widgets for progress bars (should only be needed for older versions):
13+
`jupyter nbextension enable --py widgetsnbextension`
14+
- Start a notebook server (classic): `jupyter notebook`
15+
- Start a notebook server (new): `jupyter lab`
16+
- Can use VS Code `ms-toolsai.jupyter` extension instead of installing and running your own server.

0 commit comments

Comments
 (0)