wxGUI: Support for Jupyter-based workflows

doc/jupyter_intro.md

@@ -271,7 +271,13 @@ library documentation page.
 
 ## Tutorials
 
-- [Get started with GRASS in Jupyter Notebooks on Windows](https://grass-tutorials.osgeo.org/content/tutorials/get_started/JupyterOnWindows_OSGeo4W_Tutorial.html)
-- [Get started with GRASS & Python in Jupyter Notebooks (Unix/Linux)](https://grass-tutorials.osgeo.org/content/tutorials/get_started/fast_track_grass_and_python.html)
-- [Get started with GRASS in Google Colab](https://grass-tutorials.osgeo.org/content/tutorials/get_started/grass_gis_in_google_colab.html)
-- Run `grass.jupyter` tutorial on Binder: [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/OSGeo/grass/main?labpath=doc%2Fexamples%2Fnotebooks%2Fjupyter_tutorial.ipynb)
+For local installation, see the tutorials for [Unix/Linux]
+(<https://grass-tutorials.osgeo.org/content/tutorials/get_started/fast_track_grass_and_python.html>)
+or [Windows](https://grass-tutorials.osgeo.org/content/tutorials/get_started/JupyterOnWindows_OSGeo4W_Tutorial.html).
+If you want to combine the notebook workflow with the desktop GUI experience,
+the GUI includes a built-in [Jupyter integration](wxGUI.jupyter.md) (since v8.5+).
+For cloud setup, see the [Google Colab tutorial](https://grass-tutorials.osgeo.org/content/tutorials/get_started/grass_gis_in_google_colab.html).
+
+To try GRASS in a notebook without any setup,
+run the `grass.jupyter` tutorial on Binder:
+[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/OSGeo/grass/main?labpath=doc%2Fexamples%2Fnotebooks%2Fjupyter_tutorial.ipynb)

gui/wxpython/CMakeLists.txt

@@ -8,6 +8,7 @@ set(gui_lib_DIRS
     lmgr
     location_wizard
     main_window
+    jupyter_notebook
     mapdisp
     mapwin
     modules

gui/wxpython/Makefile

@@ -9,23 +9,24 @@ include $(MODULE_TOPDIR)/include/Make/Python.make
 DSTDIR = $(GUIDIR)/wxpython
 
 SRCFILES := $(wildcard icons/*.py xml/*) \
-	$(wildcard animation/*.py core/*.py datacatalog/*.py history/*.py dbmgr/*.py gcp/*.py gmodeler/*.py \
+	$(wildcard animation/*.py core/*.py datacatalog/*.py jupyter_notebook/*.py history/*.py dbmgr/*.py gcp/*.py gmodeler/*.py \
 	gui_core/*.py iclass/*.py lmgr/*.py location_wizard/*.py main_window/*.py mapwin/*.py mapdisp/*.py \
 	mapswipe/*.py modules/*.py nviz/*.py psmap/*.py rdigit/*.py \
 	rlisetup/*.py startup/*.py timeline/*.py vdigit/*.py \
 	vnet/*.py web_services/*.py wxplot/*.py iscatt/*.py tplot/*.py photo2image/*.py image2target/*.py) \
+	$(wildcard jupyter_notebook/template_notebooks/*.ipynb) \
 	wxgui.py README.md
 
 DSTFILES := $(patsubst %,$(DSTDIR)/%,$(SRCFILES)) \
 	$(patsubst %.py,$(DSTDIR)/%.pyc,$(filter %.py,$(SRCFILES)))
 
-PYDSTDIRS := $(patsubst %,$(DSTDIR)/%,animation core datacatalog history dbmgr gcp gmodeler \
+PYDSTDIRS := $(patsubst %,$(DSTDIR)/%,animation core datacatalog jupyter_notebook history dbmgr gcp gmodeler \
 	gui_core iclass lmgr location_wizard main_window mapwin mapdisp modules nviz psmap \
 	mapswipe vdigit wxplot web_services rdigit rlisetup startup \
 	vnet timeline iscatt tplot photo2image image2target)
 
 
-DSTDIRS := $(patsubst %,$(DSTDIR)/%,icons xml)
+DSTDIRS := $(patsubst %,$(DSTDIR)/%,icons xml jupyter_notebook/template_notebooks)
 
 default: $(DSTFILES)
 ifndef CROSS_COMPILING

gui/wxpython/docs/wxGUI.jupyter.md

@@ -0,0 +1,164 @@
+---
+authors:
+    - Linda Karlovska
+    - GRASS Development Team
+---
+
+# Using Jupyter Notebooks from GUI
+
+Starting with GRASS 8.5, the GUI provides integrated support for launching
+and managing Jupyter Notebooks directly from the interface.
+This lets you combine interactive Python notebooks with your GUI workflow.
+
+## Before You Start
+
+- Linux: no additional setup is currently required.
+- Windows: setup and dependency fixes are guided automatically by GRASS dialogs.
+  For details, see [Windows Setup Details](#windows-setup-details).
+
+## Getting Started
+
+To launch Jupyter from GUI, go to **File → Jupyter Notebook** or
+click the Jupyter button in the Tools toolbar at the top of the GRASS window.
+The startup dialog lets you configure your notebook environment:
+
+![Jupyter Startup Dialog](jupyter_startup_dialog.png)
+
+### Configuration Options
+
+- **Where to Save Notebooks:** Select where your Jupyter notebooks will be stored.
+  You can choose an existing directory, create a new one, or leave the field empty
+  to use your current directory. Notebooks can be saved anywhere, including
+  inside your current GRASS project.
+
+- **Create Welcome Notebook:** Check this option to automatically create
+  a `welcome.ipynb` template notebook with GRASS-specific examples and
+  quick-start code. Recommended for new users.
+
+### Display Modes
+
+After configuring the storage, choose how to interact with Jupyter notebooks:
+
+#### Browser Mode
+
+![Browser Mode - Jupyter opened in your default web browser](jupyter_browser_mode.png)
+
+In Browser Mode, Jupyter opens in your default system web browser.
+
+This mode provides:
+
+- Full Jupyter Lab/Notebook interface with all features
+- File browser and notebook management
+- Terminal access and extensions support
+- A control panel in GRASS GUI showing server URL, PID, and storage location
+- Quick access to reopen the browser or stop the server
+
+#### Integrated Mode
+
+![Integrated Mode - Jupyter embedded directly in GRASS GUI](jupyter_integrated_mode.png)
+
+In Integrated Mode, Jupyter notebooks are embedded directly in the GRASS GUI window
+(if the wx.html2 library is available). This mode offers:
+
+- Jupyter interface embedded as a native GRASS GUI tab
+- Seamless integration with other GRASS tools and panels
+- Import/export notebooks, and create new notebooks from the toolbar
+- External links (documentation, tutorials) open in your system browser
+
+### Toolbar Actions
+
+The Integrated mode toolbar provides quick access to common operations:
+
+- **Create:** Create a new notebook with prepared GRASS module imports and session
+initialization
+- **Import:** Import existing .ipynb files into your notebook storage
+- **Export:** Export the current notebook to a different location
+- **Undock:** Open the notebook in a separate window (also available in
+the browser mode)
+- **Stop:** Stop the Jupyter server and close the notebook (also available in
+the browser mode)
+
+### Multiple Notebook Sessions
+
+You can launch multiple Jupyter sessions with different storage locations.
+Each session appears as a separate tab in the GRASS GUI, with its storage
+location shown in the tab name. Hover over a tab to see the full storage path.
+
+### Server Management
+
+GRASS automatically manages Jupyter server instances:
+
+- Each notebook storage location runs on a separate Jupyter server
+- Servers are automatically stopped when GRASS exits
+- Multiple notebooks from the same storage share one server instance
+- Server information (URL, PID) is displayed in the interface
+
+### Command Used to Start Jupyter
+
+GRASS starts Jupyter with the same command on Windows, Linux, and macOS:
+
+```bash
+<GRASS Python> -m notebook ...
+```
+
+The main reason for this choice is Windows standalone reliability. On
+Windows standalone installations, running `python -m jupyter notebook` can fail
+even when Notebook is installed and available. A typical symptom is an
+import/bootstrap error (for example `Could not import runpy._run_module_as_main`
+or `AssertionError: SRE module mismatch`).
+
+This usually indicates a Python environment mismatch in the `jupyter` launcher
+path, where imported modules do not fully match the active GRASS Python runtime.
+Using `python -m notebook` avoids that extra launcher layer.
+
+### Tips
+
+- The `welcome.ipynb` template includes GRASS session initialization
+  and practical examples of listing data, visualizing maps,
+  and running analyses with the Tools API
+
+- You can switch between browser and integrated modes by closing one and
+  relaunching Jupyter with the same storage location
+
+- Tab tooltips show the full storage path - useful when working with
+  multiple storage locations
+
+## Windows Setup Details
+
+This section describes the Windows-specific setup.
+Users on Linux and macOS can skip this section.
+
+### Install Missing Notebook Package
+
+If the `notebook` package is missing when you click **Launch Jupyter
+Notebook**, GRASS detects this automatically and opens a dialog that offers to
+install it. Clicking **Install** runs:
+
+```bash
+<GRASS Python> -m pip install notebook
+```
+
+in the current GRASS Python environment. After installation, the
+Jupyter Startup dialog opens normally.
+
+If the automatic installation fails, an error dialog displays the exact command
+you can run manually in the GRASS Python console.
+
+### Microsoft Edge WebView2 Runtime Support for Integrated Mode
+
+Integrated mode requires `wx.html2.WebView` with Microsoft Edge WebView2
+backend support. Some wxPython builds (including current OSGeo4W-based
+builds) are compiled without WebView2 support, so Integrated mode cannot start.
+
+When you choose Integrated mode and WebView2 is not available, GRASS detects
+this and opens a dialog offering to reinstall wxPython using pip. The
+reinstall keeps the currently installed wxPython version, but fetches the pip
+wheel that includes WebView2 support. Clicking **Reinstall** runs:
+
+```bash
+<GRASS Python> -m pip install --force-reinstall wxpython==<current version>
+```
+
+Because the current GRASS session still uses the previously loaded wxPython
+build, a restart is required after reinstalling. After restart, Integrated mode
+should start successfully.