diff --git a/modules/lang/org/README.org b/modules/lang/org/README.org
index 8af539491..4b279751f 100644
--- a/modules/lang/org/README.org
+++ b/modules/lang/org/README.org
@@ -173,6 +173,8 @@ esoteric features:
 + To execute babel code blocks, you need whatever dependencies those languages
   need. It is recommended you enable the associated =:lang= module and ensure
   its dependencies are met, e.g. install the =ruby= executable for ruby support.
+  To use ~jupyter kernels~ you need the =+jupyter= flag, the associatet kernel as 
+  well as the ~jupyter~ program.
 + =org-roam= (with the =+roam= flag) requires =sqlite3= to be installed.
 
 ** MacOS
@@ -185,6 +187,8 @@ brew install gnuplot
 #+BEGIN_SRC sh
 pacman -S texlive-core texlive-bin texlive-science
 pacman -S gnuplot
+# +jupyter needs jupyter
+pacman -S jupyter
 #+END_SRC
 
 ** NixOS
@@ -192,6 +196,8 @@ pacman -S gnuplot
 environment.systemPackages = with pkgs; [
   # any less than medium isn't guaranteed to work
   texlive.combined.scheme-medium
+  # +jupyter needs jupyter
+  (python38.withPackages(ps: with ps; [jupyter]))
 ];
 #+END_SRC