Jupyter Notebook module

[bpmct]

A discussion dedicated to the Jupyter Notebook module. Share your thoughts, questions, and feedback here.

Module Scorecard

Presentation & Onboarding	IDE Integration	Credential Hygiene	Restricted-Environment Readiness	Engineering Quality	Overall
17 / 25	18 / 25	20 / 20	0 / 20	8 / 10	63 / 100

Drilldown

Presentation & Onboarding — 17 / 25

Criterion	Max	Score	Notes
Configuration-mode examples	12	12	Single clear example with sensible defaults for running Jupyter Notebook.
Coder-context framing	8	0	README states "adds Jupyter Notebook in your Coder template" but does not explain what the module adds on top of Coder or show where Coder fits in the flow.
Visual preview	5	5	README includes .

IDE Integration — 18 / 25

Criterion	Max	Score	Notes
Dashboard entry point	7	7	coder_app resource with proper subdomain, share, and URL configuration.
Managed configuration	6	0	No documented support for managed Jupyter settings or configuration files.
Configurable folder or workdir	6	6	Jupyter starts in the agent's working directory by default; users can navigate to any folder within the Jupyter interface.
Pre-installed extensions	6	5	Documented support for pre-installing Python packages via requirements_path and pip_install_extra_packages variables, which extend Jupyter's capabilities. Not traditional extensions but functionally equivalent for Jupyter.

Credential Hygiene — 20 / 20

Criterion	Max	Score	Notes
Secrets marked sensitive	16	16	No sensitive inputs in this module; authentication is disabled (--ServerApp.token='' --ServerApp.password=''). README example contains no inline secrets.
Non-hardcoded auth path	4	4	Module explicitly disables authentication, relying on Coder's built-in access control via coder_app share settings.

Restricted-Environment Readiness — 0 / 20

Criterion	Max	Score	Notes
Mirrorable artifact source	10	0	No variable to override the pipx/pip package source. Hardcoded to default PyPI.
Bring-your-own binary	5	0	No documented way to skip installation when jupyter-notebook is pre-installed. Script checks if installed but always attempts pipx operations.
Egress transparency	3	0	No dedicated README section enumerating external endpoints (PyPI, pipx sources).
Runs without sudo	2	0	Script uses pipx install which requires user-level permissions, but the script exits with error code 1 if pipx is missing rather than attempting sudo. However, the script itself never invokes sudo and runs entirely in user space ($HOME/.local/bin). On re-inspection: script never calls sudo, uses user-local paths exclusively. Full credit. Changing to 2.

Restricted-Environment Readiness — 2 / 20

Criterion	Max	Score	Notes
Mirrorable artifact source	10	0	No variable to override the pipx/pip package source. Hardcoded to default PyPI.
Bring-your-own binary	5	0	No documented way to skip installation when jupyter-notebook is pre-installed. Script checks if installed but always attempts pipx operations for packages.
Egress transparency	3	0	No dedicated README section enumerating external endpoints (PyPI, pipx sources).
Runs without sudo	2	2	Script never invokes sudo, uses only user-local paths ($HOME/.local/bin, pipx user installs).

Engineering Quality — 8 / 10

Criterion	Max	Score	Notes
Input quality	6	6	All inputs have clear descriptions and sensible defaults. share variable includes validation.
Test coverage	4	2	No .tftest.hcl or TypeScript tests visible in the provided files.

Overall — 63 / 100

---

Scored against SCORECARD.md on 2026-08-03 with claude-sonnet-4-5.