NLP use-case template without Model Control Plane

.scripts/format.sh

@@ -0,0 +1,14 @@
+#!/bin/sh -e
+set -x
+
+SRC=${1:-"template tests .scripts"}
+
+export ZENML_DEBUG=1
+export ZENML_ANALYTICS_OPT_IN=false
+
+# autoflake replacement: removes unused imports and variables
+ruff $SRC --select F401,F841 --fix --exclude "__init__.py" --isolated
+
+# sorts imports
+ruff $SRC --select I --fix --ignore D
+black $SRC

README.md

@@ -1 +1,69 @@
-# 💫 ZenML End-to-End Natural Language Processing Project Template
+# 💫 ZenML End-to-End NLP Training and Deployment Project Template
+
+This project template is designed to help you get started with training and deploying NLP models using the ZenML framework. It provides a comprehensive set of steps and pipelines to cover major use cases of NLP model development, including dataset loading, tokenization, model training, model registration, and deployment.
+
+## 📃 Template Parameters
+
+| Parameter | Description | Default |
+|-----------|-------------|---------|
+| Name | The name of the person/entity holding the copyright | ZenML GmbH |
+| Email | The email of the person/entity holding the copyright | [email protected] |
+| Project Name | Short name for your project | ZenML NLP project |
+| Project Version | The version of your project | 0.0.1 |
+| Project License | The license under which your project will be released | Apache Software License 2.0 |
+| Technical product name | The technical name to prefix all tech assets (pipelines, models, etc.) | nlp_use_case |
+| Target environment | The target environment for deployments/promotions | staging |
+| Use metric-based promotion | Whether to compare metric of interest to make model version promotion | True |
+| Notifications on failure | Whether to notify about pipeline failures | True |
+| Notifications on success | Whether to notify about pipeline successes | False |
+| ZenML Server URL | Optional URL of a remote ZenML server for support scripts | - |
+
+## 🚀 Generate a ZenML Project
+
+To generate a project from this template, make sure you have ZenML and its `templates` extras installed:
+
+```bash
+pip install zenml[templates]
+```
+
+Then, run the following command to generate the project:
+
+```bash
+zenml init --template nlp-template
+```
+
+You will be prompted to provide values for the template parameters. If you want to use the default values, you can add the `--template-with-defaults` flag to the command.
+
+## 🧰 How this template is implemented
+
+This template provides a set of pipelines and steps to cover the end-to-end process of training and deploying NLP models. Here is an overview of the main components:
+
+### Dataset Loading
+
+The template includes a step for loading the dataset from the HuggingFace Datasets library. You can choose from three available datasets: financial_news, airline_reviews, and imbd_reviews.
+
+### Tokenization
+
+The tokenization step preprocesses the dataset by tokenizing the text data using the tokenizer provided by the HuggingFace Models library. You can choose from three available models: bert-base-uncased, roberta-base, and distilbert-base-cased.
+
+### Model Training
+
+The training pipeline consists of several steps, including model architecture search, hyperparameter tuning, model training, and model evaluation. The best model architecture and hyperparameters are selected based on the performance on the validation set. The trained model is then evaluated on the holdout set to assess its performance.
+
+### Model Registration and Promotion
+
+After training, the best model version is registered in the ZenML Model Registry. The template provides an option to promote the model version based on a specified metric of interest. If metric-based promotion is enabled, the template compares the metric value of the new model version with the metric value of the current production model version and promotes the new version if it performs better.
+
+### Batch Inference
+
+The template includes a batch inference pipeline that loads the inference dataset, preprocesses it using the same tokenizer as during training, and runs predictions using the deployed model version. The predictions are stored as an artifact for future use.
+
+### Deployment Options
+
+The template provides options to deploy the trained model locally or to the HuggingFace Hub. You can choose whether to deploy locally or to the HuggingFace Hub by setting the `deploy_locally` and `deploy_to_huggingface` parameters.
+
+## Next Steps
+
+Once you have generated the project using this template, you can explore the generated code and customize it to fit your specific NLP use case. The README.md file in the generated project provides further instructions on how to set up and run the project.
+
+Happy coding with ZenML and NLP!

copier.yml

@@ -49,7 +49,7 @@ email:
     when: "{{ open_source_license != 'none' }}"
 product_name:
     type: str
-    help: The technical name of the data product you are building
+    help: The technical name of the data product you are building, Make sure it's one word and all lowercase (e.g. nlp_use_case)
     default: nlp_use_case
 target_environment:
     type: str
@@ -58,28 +58,52 @@ target_environment:
         - production
         - staging
     default: staging
+accelerator:
+    type: str
+    help: "The accelerator to use for training"
+    choices:
+        - gpu
+        - cpu
+    default: gpu
+deploy_locally:
+    type: bool
+    help: "Whether to deploy locally"
+    default: True
+deploy_to_huggingface:
+    type: bool
+    help: "Whether to deploy to HuggingFace Hub"
+    default: False
+deploy_to_skypilot:
+    type: bool
+    help: "Whether to deploy to SkyPilot"
+    default: False
 dataset:
     type: str
     help: "The name of the dataset to use from HuggingFace Datasets"
     choices:
         - financial_news
         - airline_reviews
         - imbd_reviews
-    default: financial_news
+    default: airline_reviews
 model:
     type: str
     help: "The name of the model to use from HuggingFace Models"
     choices:
-        - bert
-        - gpt2
-    default: bert
+        - bert-base-uncased
+        - roberta-base
+        - distilbert-base-cased
+    default: roberta-base
 cloud_of_choice:
     type: str
     help: "Whether to use AWS cloud provider or GCP"
     choices:
         - aws
         - gcp
     default: aws
+metric_compare_promotion:
+    type: bool
+    help: "Whether to promote model versions based on metrics? Otherwise, latest trained will get promoted."
+    default: True
 notify_on_failures:
     type: bool
     help: "Whether to notify on pipeline failures?"
@@ -92,10 +116,6 @@ zenml_server_url:
     type: str
     help: "The URL of the ZenML server [Optional]"
     default: ""
-custom_training:
-    type: bool
-    help: "Whether to use custom training or not"
-    default: False
 # CONFIGURATION -------------------------
 _templates_suffix: ""
 _subdirectory: template

template/Makefile

@@ -11,4 +11,15 @@ setup:
 	pip install -r requirements.txt
 	zenml integration install pytorch mlflow s3 gcp aws slack transformers -y
 
-install-stack:
+install-local-stack:
+	@echo "Specify stack name [$(stack_name)]: " && read input && [ -n "$$input" ] && stack_name="$$input" || stack_name="$(stack_name)" && \
+	zenml experiment-tracker register -f mlflow mlflow_local_$${stack_name} && \
+	zenml model-registry register -f mlflow mlflow_local_$${stack_name} && \
+	zenml model-deployer register -f mlflow mlflow_local_$${stack_name} && \
+	zenml stack register -a default -o default -r mlflow_local_$${stack_name} \
+	-d mlflow_local_$${stack_name} -e mlflow_local_$${stack_name} $${stack_name} && \
+	zenml stack set $${stack_name} && \
+	zenml stack up
+
+install-remote-stack:
+

template/config.yaml

@@ -0,0 +1,34 @@
+# {% include 'template/license_header' %}
+
+settings:
+  docker:
+{%- if accelerator == 'gpu' %}
+    parent_image: 'huggingface/transformers-pytorch-gpu'
+{%- endif %}
+    required_integrations:
+{%- if cloud_of_choice == 'aws' %}
+      - aws
+      - skypilot_aws
+      - s3
+{%- endif %}
+{%- if cloud_of_choice == 'gcp' %}
+      - gcp
+      - skypilot_gcp
+{%- endif %}
+      - huggingface
+      - pytorch
+      - mlflow
+      - discord
+    requirements:
+      - accelerate
+      - zenml[server]
+
+extra:
+  mlflow_model_name: nlp_use_case_model
+{%- if target_environment == 'production' %}
+  target_env: Production
+{%- else %}
+  target_env: Staging
+{%- endif %}
+  notify_on_success: False
+  notify_on_failure: True

template/gradio/Dockerfile

@@ -0,0 +1,26 @@
+# read the doc: https://huggingface.co/docs/hub/spaces-sdks-docker
+# you will also find guides on how best to write your Dockerfile
+
+FROM python:3.9
+
+WORKDIR /code
+
+COPY ./requirements.txt /code/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+# Set up a new user named "user" with user ID 1000
+RUN useradd -m -u 1000 user
+# Switch to the "user" user
+USER user
+# Set home to the user's home directory
+ENV HOME=/home/user \
+    PATH=/home/user/.local/bin:$PATH
+
+# Set the working directory to the user's home directory
+WORKDIR $HOME/app
+
+# Copy the current directory contents into the container at $HOME/app setting the owner to the user
+COPY --chown=user . $HOME/app
+
+CMD ["python", "app.py", "--server.port=7860", "--server.address=0.0.0.0"]

template/gradio/__init__.py

@@ -0,0 +1 @@
+# {% include 'template/license_header' %}