---
title: Composable ML Quickstart
description: The Quickstart provides an example that walks you through testing and learning Composable ML so that you can then apply it against your own use case.

---

# Composable ML Quickstart {: #composable-ml-quickstart }

Composable ML gives you full flexibility to build a custom ML algorithm and then use it together with other built-in capabilities (like the model Leaderboard or MLOps) to streamline your end-to-end flow and improve productivity. This Quickstart provides an example that walks you through testing and learning Composable ML so that you can then apply it against your own use case.

In the following sections you will build a blueprint with a custom algorithm. Specifically you will:

1. Create a project and open the blueprint editor.
2. Replace the missing values imputation task with a built-in alternative.
3. Create a custom missing values imputation task.
4. Add the custom task into a blueprint and train.
5. Evaluate the results and deploy.

## Create a project and open the blueprint editor {: #create-a-project-and-open-the-blueprint-editor }

This example replaces a built-in Missing Values Imputed task with a custom imputation task. To begin, create a project and open the blueprint editor.

1. Start a project with the [10K Lending Club Loans](https://s3.amazonaws.com/datarobot_public_datasets/10K_Lending_Club_Loans.csv){ target=_blank } dataset. You can download it and import as a local file or provide the URL. Use the following parameters to configure a project:
	* Target: **is_bad**
	* Autopilot mode: full or Quick

2. When available, expand a model on the Leaderboard to open the **Describe > Blueprint** tab. Click **Copy and edit** to open the [blueprint editor](cml-blueprint-edit), where you can add, replace, or remove tasks from the blueprint (as well as save the blueprint to the AI Catalog).

	![](images/cml-qs-1.png)

## Replace a task {: #replace-a-task }

Replace the Missing Values Imputed task within the blueprint with an alternate and save the new blueprint to the AI Catalog.

1. Select **Missing Values Imputed** and then click the pencil icon (![](images/icon-pencil.png)) to edit the task.

	![](images/cml-qs-13.png)

2. In the resulting dialog, [select an alternate](cml-blueprint-edit#use-the-task-selector)  missing values imputation task.

	* Click on the task name.
	* Expand **Preprocessing > Numeric Preprocessing**.
	* Select **Missing Values Imputed [PNI2]**.

	![](images/cml-qs-2.png)

	Once selected, click **Update** to modify the task.

3. Click **Add to AI Catalog** to save it to the [AI Catalog](cml-catalog) for further editing, use in other projects, and sharing.

4. Evaluate potential issues by hovering on any highlighted task. When you have confirmed that all tasks are okay, [train the model](cml-blueprint-edit#train-new-models).

	![](images/cml-qs-14.png)

Once trained, the new model appears in the project’s Leaderboard where you can, for example, compare accuracy to other blueprints, explore insights, or deploy the model.

## Create a custom task {: #create-a-custom-task }

To use an algorithm that is not available among the built-in tasks, you can define a custom task using code. Once created, you then upload that code as a task and use it to define one or multiple blueprints. This part of the quickstart uses one of the [task templates](https://github.com/datarobot/datarobot-user-models/tree/master/task_templates) provided by DataRobot, however you can also [create your own](cml-custom-tasks) custom task.

When you have finished writing task code (locally), making the custom task available within the DataRobot platform involves three steps:

1. Add a new custom task in the Model Registry.
2. Select the environment where the task runs.
3. Upload the task code into DataRobot.

### Add a new task {: #add-a-new-task}

To create a new task, navigate to **Model Registry > Custom Model Workshop > Tasks** and select **+ Add new task**.

![](images/cml-qs-3.png)

1. Provide a name for the task, MVI in this example.
2. Select the [task type](cml-blueprint-edit#blueprint-task-types), either **Estimator** or **Transform**. This example creates a transform (since missing values imputation is a transformation).

	??? note "If you create a custom estimator"

     	When creating an estimator task, select the target (project) type where the task will be used. As an estimator, it can only then be used with the identified project type.

     	![](images/cml-qs-4.png)

4. Click **Add Custom Task**.

### Select the environment {: #select-the-environment}

Once the task type is created, select the container environment where the task will run. This example uses one of the environments provided by DataRobot but you can also create your own [custom environment](custom-environments#create-a-custom-environment).

Under **Transform Environment**, click **Base Environment** and select **[DataRobot] Python 3 Scikit-Learn Drop-In**.

![](images/cml-qs-5.png)

### Upload task content {: #upload-task-content}

Once you select an environment, the option to load task content (code) becomes available. You can import it directly from your local machine or, as in this example, upload it from GitHub.

1. Click **Select remote repository**.
2. If needed:

	* Register a new GitHub repository by clicking **Add new** and selecting **GitHub**.

		![](images/cml-qs-6.png)

	* [Authorize the GitHub app](custom-model-repos#github-repository) and supply `https://github.com/datarobot/datarobot-user-models` as the URL.

3. In the resulting window, select the remote repository you just created and click **Select content**.

5. When prompted for the content to be pulled from the GitHub repository:

	* In the **GitHub reference** field, begin typing to select **master**.
	* In the **Specify path to the artifacts** field enter `task_templates/1_transforms/1_python_missing_values`.

6. Click **Pull** to create the task.

Once DataRobot processes the GitHub content, the new task version and the option to apply the task become available. The task version is also saved to **Model Registry > Custom Model Workshop > Tasks**.

![](images/cml-qs-7.png)

## Apply new task and train {: #apply-new-task-and-train }

To apply a new task:

1. Return to the Leaderboard and select any model. Click **Copy and Edit** to modify the blueprint.

	![](images/cml-qs-15.png)

2. Select the Missing Values Imputed or Numeric Data Cleansing task and click the pencil (![](images/icon-pencil.png)) icon to [modify it](cml-blueprint-edit#modify-a-node).

3. In the task window, click on the task name to replace it. Under **Custom**, select the task you created. Click **Update**.

	![](images/cml-qs-8.png)

4. Click **Train** (upper right) to open a window where you set training characteristics and create a new model from the Leaderboard.

!!! tip
    Consider relabeling your customized blueprint so that it is easy to locate on the Leaderboard.

## Evaluate and deploy {: #evaluate-and-deploy }

Once trained, the model appears in the project Leaderboard where you can compare its accuracy with other custom and DataRobot models. The icon changes to indicate a user model. At this point, the model is treated like any other model, providing metrics and model-agnostic insights and it can be deployed and managed through MLOps.

Compare metrics:

![](images/cml-qs-10.png)

View [**Feature Impact**](feature-impact):

![](images/cml-qs-11.png)

!!! note
	For models trained from customized blueprints, **Feature Impact** is always computed using the [permutation-based approach](feature-impact#shared-permutation-based-feature-impact), regardless of the project settings.

Use [**Model Comparison**](model-compare):

![](images/cml-qs-12.png)

[Deploy the best model](deploy-model) in a few clicks.

For more information on using Composable ML, see the other available [learning resources](cml-overview#get-started-with-composable-ml).
