Verify Notebooks
Verify and test Jupyter notebooks in the CoursIA repository.
Target: $ARGUMENTS
Arguments
- •
target: Notebook path, family name (Sudoku,Search,SymbolicAI,Argument_Analysis,GenAI,ML,Probas,IIT,Tweety,Lean,GameTheory), orall - •
--quick: Structure validation only, no execution - •
--fix: Attempt automatic fixes (max 3 attempts per cell) - •
--python-only/--dotnet-only: Filter by kernel type
Process
- •Parse target - Determine individual file, family, or all
- •Discover notebooks - Use
python scripts/notebook_tools.py validate {target} --quickfor rapid discovery and structure check - •Categorize by kernel -
python scripts/notebook_helpers.py detect-kernel {path} - •Execute tests:
- •Python (preferred):
python scripts/notebook_tools.py execute {target} --timeout 300 - •Python (alternative):
python scripts/notebook_helpers.py execute {path} --verbose(cell-by-cell with output) - •.NET: MCP cell-by-cell only (see
mcp-jupyterskill) - Papermill does NOT work
- •Python (preferred):
- •Analyze errors -
python scripts/notebook_helpers.py list {path} --verboseto inspect failed cells - •If --fix: Use notebook-cell-iterator agent (model: sonnet) for targeted cell corrections (max 3 attempts)
- •Generate summary report
Family Reference
| Family | Path | Kernel | Notes |
|---|---|---|---|
| Sudoku | Sudoku/ | .NET C# | #!import, cell-by-cell only |
| Search | Search/ | Mixed | GeneticSharp=C#, PyGad=Python |
| SymbolicAI | SymbolicAI/ | Mixed | Tweety=Python+JPype |
| GenAI | GenAI/ | Python | API keys required, use /validate-genai first |
| Probas | Probas/ | .NET C# | Infer.NET |
| GameTheory | GameTheory/ | Python (WSL) | OpenSpiel |
| Lean | SymbolicAI/Lean/ | Lean 4 / Python (WSL) | WSL kernels |
GenAI-Specific
For GenAI notebooks, use dedicated scripts:
bash
python scripts/genai-stack/validate_stack.py python scripts/genai-stack/validate_notebooks.py MyIA.AI.Notebooks/GenAI/Image/
Use /validate-genai to validate the stack before running notebooks.
Known Limitations
- •Widgets/interactive notebooks cannot run in batch mode
- •GenAI notebooks require GPU for some operations
- •.NET cold start may timeout initially (30-60s), retry once
- •External services (DBpedia, etc.) may be unavailable