Prod deploy — May 9th, 2025

.github/actions/demo-notebook/action.yml

@@ -1,4 +1,4 @@
-name: Execute demo notebook
+name: Execute demo notebooks
 description: Installs python3, validmind, checks dependencies then executes ONLY the Intro for Model Developers notebook with development heap tracking
 
 inputs:
@@ -24,6 +24,11 @@ runs:
         pip install shap==0.44.1
         pip install anywidget
 
+    - name: Register validmind kernel
+      shell: bash
+      run: |
+        python -m ipykernel install --user --name validmind --display-name "ValidMind Library"
+
     - name: Ensure .env file is available
       shell: bash
       id: find_env
@@ -33,14 +38,14 @@ runs:
           exit 1
         fi
 
-    - name: Execute ONLY the Intro for Model Developers notebook with heap development
+    - name: Execute ONLY the ValidMind for model development series with heap development
       shell: bash
       if: ${{ steps.find_env.outcome == 'success' }}
       run: |
           cd site
           source ../${{ inputs.env_file }}
-          quarto render --profile exe-demo notebooks/tutorials/intro_for_model_developers_EXECUTED.ipynb &> render_errors.log || {
-          echo "Execute for intro_for_model_developers_EXECUTED.ipynb failed";
+          quarto render --profile exe-demo notebooks/EXECUTED/model_development &> render_errors.log || {
+          echo "Execute for ValidMind for model development series failed";
           cat render_errors.log;
           exit 1;
           }

.github/actions/prod-notebook/action.yml

@@ -1,4 +1,4 @@
-name: Execute prod notebook
+name: Execute prod notebooks
 description: Installs python3, validmind, checks dependencies then executes ONLY the Intro for Model Developers notebook with production heap tracking
 
 inputs:
@@ -24,6 +24,11 @@ runs:
         pip install shap==0.44.1
         pip install anywidget
 
+    - name: Register validmind kernel
+      shell: bash
+      run: |
+        python -m ipykernel install --user --name validmind --display-name "ValidMind Library"
+
     - name: Ensure .env file is available
       shell: bash
       id: find_env
@@ -33,14 +38,14 @@ runs:
           exit 1
         fi
 
-    - name: Execute ONLY the Intro for Model Developers notebook with heap production
+    - name: Execute ONLY the ValidMind for model development series with heap production
       shell: bash
       if: ${{ steps.find_env.outcome == 'success' }}
       run: |
           cd site
           source ../${{ inputs.env_file }}
-          quarto render --profile exe-prod notebooks/tutorials/intro_for_model_developers_EXECUTED.ipynb &> render_errors.log || {
-          echo "Execute for intro_for_model_developers_EXECUTED.ipynb failed";
+          quarto render --profile exe-prod notebooks/EXECUTED/model_development &> render_errors.log || {
+          echo "Execute for ValidMind for model development series failed";
           cat render_errors.log;
           exit 1;
           }

.github/actions/staging-notebook/action.yml

@@ -1,4 +1,4 @@
-name: Execute staging notebook
+name: Execute staging notebooks
 description: Installs python3, validmind, checks dependencies then executes ONLY the Intro for Model Developers notebook with staging heap tracking
 
 inputs:
@@ -24,6 +24,11 @@ runs:
         pip install shap==0.44.1
         pip install anywidget
 
+    - name: Register validmind kernel
+      shell: bash
+      run: |
+        python -m ipykernel install --user --name validmind --display-name "ValidMind Library"
+
     - name: Ensure .env file is available
       shell: bash
       id: find_env
@@ -33,14 +38,14 @@ runs:
           exit 1
         fi
 
-    - name: Execute ONLY the Intro for Model Developers notebook with heap staging
+    - name: Execute ONLY the ValidMind for model development series with heap staging
       shell: bash
       if: ${{ steps.find_env.outcome == 'success' }}
       run: |
           cd site
           source ../${{ inputs.env_file }}
-          quarto render --profile exe-staging notebooks/tutorials/intro_for_model_developers_EXECUTED.ipynb &> render_errors.log || {
-          echo "Execute for intro_for_model_developers_EXECUTED.ipynb failed";
+          quarto render --profile exe-staging notebooks/EXECUTED/model_development &> render_errors.log || {
+          echo "Execute for iValidMind for model development series failed";
           cat render_errors.log;
           exit 1;
           }

.github/workflows/deploy-docs-prod.yaml

@@ -59,7 +59,7 @@ jobs:
           cat .env
 
       # Only execute the prod notebook if .env file is created
-      - name: Execute prod Intro for Model Developers notebook
+      - name: Execute prod ValidMind for model development series
         if: ${{ steps.create_env.outcome == 'success' }}
         uses: ./.github/actions/prod-notebook
         id: execute-prod-notebook
@@ -71,4 +71,4 @@ jobs:
         run: aws configure set aws_access_key_id ${{ secrets.AWS_ACCESS_KEY_ID }} && aws configure set aws_secret_access_key ${{ secrets.AWS_SECRET_ACCESS_KEY }} && aws configure set default.region us-east-1
 
       - name: Deploy docs prod site
-        run: aws s3 sync site/_site s3://docs-ci-cd-prod/site --delete && aws cloudfront create-invalidation --distribution-id E2I9R40IH01NW3 --paths "/*" --no-cli-pager
+        run: aws s3 sync site/_site s3://docs-ci-cd-prod/site --delete --exclude "site/installation/helm-repo/*" && aws cloudfront create-invalidation --distribution-id E2I9R40IH01NW3 --paths "/*" --no-cli-pager

.github/workflows/deploy-docs-staging.yaml

@@ -49,7 +49,7 @@ jobs:
           cat .env
 
       # Only execute the staging notebook if .env file is created
-      - name: Execute staging Intro for Model Developers notebook
+      - name: Execute staging ValidMind for model development series
         if: ${{ steps.create_env.outcome == 'success' }}
         uses: ./.github/actions/staging-notebook
         id: execute-staging-notebook
@@ -61,4 +61,4 @@ jobs:
         run: aws configure set aws_access_key_id ${{ secrets.AWS_ACCESS_KEY_ID_STAGING }} && aws configure set aws_secret_access_key ${{ secrets.AWS_SECRET_ACCESS_KEY_STAGING }} && aws configure set default.region us-west-2
 
       - name: Deploy docs staging site
-        run: aws s3 sync site/_site s3://docs-ci-cd-staging/site --delete && aws cloudfront create-invalidation --distribution-id E2FB73KGY63MV6 --paths "/*" --no-cli-pager
+        run: aws s3 sync site/_site s3://docs-ci-cd-staging/site --delete --exclude "site/installation/helm-repo/*" && aws cloudfront create-invalidation --distribution-id E2FB73KGY63MV6 --paths "/*" --no-cli-pager

.github/workflows/validate-docs-site.yaml

@@ -72,8 +72,8 @@ jobs:
         cat .env
 
     # Only execute the demo notebook if .env file is created
-    - name: Execute demo Intro for Model Developers notebook
-      if: ${{ env.ENABLE_DEMO_NOTEBOOK == 'true' && steps.create_env.outcome == 'success' }}
+    - name: Execute demo ValidMind for model development series
+      if: ${{ vars.ENABLE_DEMO_NOTEBOOK == 'true' && steps.create_env.outcome == 'success' }}
       uses: ./.github/actions/demo-notebook
       id: execute-demo-notebook
       with:

site/Makefile

@@ -2,7 +2,7 @@
 DEST_DIR_NB := notebooks
 DEST_DIR_PYTHON := validmind
 DEST_DIR_TESTS := tests
-FILE_PATH := notebooks/tutorials/intro_for_model_developers_EXECUTED.ipynb 
+FILE_PATH := notebooks/EXECUTED/model_development
 GIT_BRANCH := $(shell git rev-parse --abbrev-ref HEAD)
 INSTALLATION_BRANCH := main
 LIBRARY_BRANCH ?= $(or $(BRANCH),main)
@@ -43,6 +43,7 @@ clean:
 	@echo "\nDeleting copies of files sourced from other repos ..."
 	rm -rf $(SRC_DIR)
 	rm -rf $(SRC_ROOT)
+	rm -rf notebooks/EXECUTED/model_development/
 
 # Prompt for a branch or release tag and clone the repository
 clone:
@@ -86,7 +87,7 @@ deploy-prod:
 	else \
 		echo "\nDeploying prod site ..."; \
 		cp -r $(SRC_ROOT)/installation/site/installation installation
-		quarto render --profile production && aws s3 sync ./_site s3://docs-ci-cd-prod/site/ --delete && aws cloudfront create-invalidation --distribution-id E2I9R40IH01NW3 --paths "/*" --no-cli-pager > /dev/null; \
+		quarto render --profile production && aws s3 sync ./_site s3://docs-ci-cd-prod/site/ --delete --exclude "site/installation/helm-repo/*" && aws cloudfront create-invalidation --distribution-id E2I9R40IH01NW3 --paths "/*" --no-cli-pager > /dev/null; \
 	fi
 
 # Deployment to https://docs-staging.validmind.ai/
@@ -96,7 +97,7 @@ deploy-staging:
 	else \
 		echo "\nDeploying staging site ..."; \
 		cp -r $(SRC_ROOT)/installation/site/installation installation
-		quarto render --profile staging && aws s3 sync ./_site s3://docs-ci-cd-staging/site/ --delete && aws cloudfront create-invalidation --distribution-id E2FB73KGY63MV6 --paths "/*" --no-cli-pager > /dev/null; \
+		quarto render --profile staging && aws s3 sync ./_site s3://docs-ci-cd-staging/site/ --delete --exclude "site/installation/helm-repo/*" && aws cloudfront create-invalidation --distribution-id E2FB73KGY63MV6 --paths "/*" --no-cli-pager > /dev/null; \
 	fi
 
 docker-build: docker-site-lite
@@ -122,7 +123,7 @@ docs-site: get-source
 	quarto render --profile production
 	@$(MAKE) execute PROFILE=exe-prod
 
-# Will default to `exe-demo` profile & the `notebooks/tutorials/intro_for_model_developers_EXECUTED.ipynb` if no input provided
+# Will default to `exe-demo` profile & the `notebooks/EXECUTED/model_development` if no input provided
 execute:
 	quarto render --profile $(PROFILE) $(FILE_PATH)
 
@@ -135,8 +136,9 @@ notebooks:
 	@rm -f notebooks.zip
 	@rm -rf $(DEST_DIR_NB)/ && mkdir -p $(DEST_DIR_NB)
 	@cp -r $(SRC_DIR)/notebooks/. $(DEST_DIR_NB)/
-	@echo "Duplicating notebooks/tutorials/intro_for_model_developers.ipynb for execution"
-	@cp notebooks/tutorials/intro_for_model_developers.ipynb notebooks/tutorials/intro_for_model_developers_EXECUTED.ipynb
+	@echo "Duplicating all files from notebooks/tutorials/model_development/ for execution"
+	@mkdir -p notebooks/EXECUTED/model_development/
+	@cp -r notebooks/tutorials/model_development/* notebooks/EXECUTED/model_development/
 	@echo "Copying LICENSE into notebooks ..."
 	@cp -r $(SRC_DIR)/LICENSE $(DEST_DIR_NB)/
 	@rm -rf $(DEST_DIR_NB)/code_sharing
@@ -184,11 +186,3 @@ yearly-releases:
 	cd ../
 	git status | grep -v 'release-scripts/'
 	quarto preview
-
-
-
-
-
-
-
-

site/_extensions/gadenbuie/now/_extension.yml

@@ -0,0 +1,8 @@
+title: Now
+author: Garrick Aden-Buie
+version: 1.0.0
+quarto-required: ">=1.4.0"
+contributes:
+  shortcodes:
+    - now.lua
+