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 the web IDE use case.
Coder-context framing	8	0	README does not explain what the module adds on top of Coder or how Coder fits in the flow; it only states "adds Jupyter Notebook in your Coder template."
Visual preview	5	5	README includes  showing the module in action.

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 this tool.

Credential Hygiene — 20 / 20

Criterion	Max	Score	Notes
Secrets marked sensitive	16	16	No sensitive inputs exist; the module intentionally disables authentication (--ServerApp.token='' --ServerApp.password='') and relies on Coder's authentication layer.
Non-hardcoded auth path	4	4	Authentication is handled entirely by Coder's app proxy; no keys or tokens are required in the template.

Restricted-Environment Readiness — 0 / 20

Criterion	Max	Score	Notes
Mirrorable artifact source	10	0	No variable to override the pipx/pip package source. The module hardcodes pipx install notebook with no registry override.
Bring-your-own binary	5	0	No documented way to skip installation when jupyter-notebook is pre-installed. The script checks command -v jupyter-notebook but still attempts package installation via pipx.
Egress transparency	3	0	No dedicated README section enumerating external endpoints (PyPI, pipx sources).
Runs without sudo	2	0	Script requires pipx to be pre-installed and exits with error if missing (exit 1), but the actual jupyter-notebook installation and runtime commands run without sudo. However, the script does not document the no-sudo path and the pipx prerequisite is not clearly framed as a non-root requirement. Scores 0 because the error path is not graceful and documentation is absent.

Engineering Quality — 8 / 10

Criterion	Max	Score	Notes
Input quality	6	6	All inputs have clear descriptions and sensible defaults. The share variable includes proper validation. Port, log_path, order, group, requirements_path, and pip_install_extra_packages are well-defined.
Test coverage	4	2	No .tftest.hcl or TypeScript tests visible in the provided files. Testing story is unclear.

Overall — 63 / 100

---

Scored against SCORECARD.md on 2026-07-15 with claude-sonnet-4-5.