azureml-examples/prefix.md

Azure Machine Learning (AML) Examples

Welcome to the Azure Machine Learning (AML) examples repository!

Prerequisites

1. An Azure subscription. If you don't have an Azure subscription, create a free account before you begin.
2. A terminal and Python >=3.6,<3.9.

Setup

Clone this repository and install required packages:

git clone https://github.com/Azure/azureml-examples --depth 1
cd azureml-examples
pip install --upgrade -r requirements.txt

To create or setup a workspace with the assets used in these examples, run the setup script.

If you do not have an AML Workspace, run python setup-workspace.py --subscription-id $ID, where $ID is your Azure subscription id. A resource group, AML Workspace, and other necessary resources will be created in the subscription.

If you have an AML Workspace, install the AML CLI and run az ml folder attach -w $WS -g $RG, where $WS and $RG are the workspace and resource group names.

Run python setup-workspace.py -h to see other arguments.

Getting started

To get started, see the introductory tutorial which uses AML to:

• run a "hello world" job on cloud compute, demonstrating the basics
• run a series of PyTorch training jobs on cloud compute, demonstrating mlflow tracking & using cloud data

These concepts are sufficient to understand all examples in this repository, which are listed below.

Contents

A lightweight template repository for automating the ML lifecycle can be found here.

directory	description
.cloud	cloud templates
.github	GitHub specific files like Actions workflow yaml definitions and issue templates
notebooks	interactive jupyter notebooks for iterative ML development
tutorials	self-contained directories of end-to-end tutorials
workflows	self-contained directories of job to be run, organized by scenario then tool then project

Examples