azureml-examples/README.md

# Azure Machine Learning examples

[![license: MIT](https://img.shields.io/badge/License-MIT-purple.svg)](LICENSE)

Welcome to the Azure Machine Learning examples repository!

## About This Repository

The azureml-examples repository contains examples and tutorials to help you learn how to use Azure Machine Learning
(Azure ML) services and features.


### Getting Started

If you're getting started with Azure ML, consider working through our [tutorials] for the v2 Python SDK. You may
also want to read through our [documentation](#supplementary-documentation).

### SDKs

The `sdk/` folder houses the examples for the Azure ML SDKs across several languages.

We have an extensive collection of examples for the [Azure ML Python SDK v2][azure cli ml extension v2 overview] in
[`sdk/python`][azureml python sdk v2 examples].

We also offer some examples for our SDKs in other languages:

* .NET: [`sdk/dotnet`][azureml dotnet sdk v2 examples]
* TypeScript: [`sdk/typescript`][azureml typescript sdk v2 examples]

### Azure Machine Learning extension for Azure CLI

The [`cli/` folder][azureml cli extension examples] hosts our examples to use the
[Azure Machine Learning extension][azure cli ml extension v2 overview] for [Azure CLI][azure cli overview].

_Note_: If you're looking for examples that submit Azure ML jobs that run non-Python code, see:

* **R**: [`cli/jobs/single-step/r`](./cli/jobs/single-step/r)


## Supplementary Documentation

- [Azure Machine Learning Documentation](https://docs.microsoft.com/azure/machine-learning)
- [AzureML Python SDK v2 Overview]
- [Azure CLI ML extension v2 Overview]

## Contributing

We welcome contributions and suggestions! Please see the [contributing guidelines](CONTRIBUTING.md) for details.

## Code of Conduct

This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). Please see the [code of conduct](CODE_OF_CONDUCT.md) for details.

[tutorials]: ./tutorials
[azure cli overview]: https://learn.microsoft.com/en-us/cli/azure/what-is-azure-cli
[azureml cli extension examples]: ./cli
[azureml python sdk v2 examples]: ./sdk/python
[azureml dotnet sdk v2 examples]: ./sdk/dotnet
[azureml typescript sdk v2 examples]: ./sdk/typescript
[azure cli ml extension v2 overview]: https://learn.microsoft.com/en-us/azure/machine-learning/concept-v2?view=azureml-api-2#azure-machine-learning-cli-v2
[azureml python sdk v2 overview]: https://learn.microsoft.com/en-us/azure/machine-learning/concept-v2?view=azureml-api-2#azure-machine-learning-python-sdk-v2
minor edits to root readme (#502) 2021-05-12 20:17:00 +03:00			`# Azure Machine Learning examples`
reset git history - final 2020-11-11 23:56:18 +03:00
			`[![license: MIT](https://img.shields.io/badge/License-MIT-purple.svg)](LICENSE)`

refactor readme.py and workflow logic (#342) * saving * prefix edit * save for later * save for later * fix typos * logic * fix and rerun readme * add dataprep to reqs * remove papermill -k * add azureml-train back to reqs * try this * revert and pin papermill version * edit workflows * same to other workflows * revert * blaming vim * out of ideas * try this * facepalm? * run tutorials too * edit prefix 2021-02-01 04:13:21 +03:00			`Welcome to the Azure Machine Learning examples repository!`
reset git history - final 2020-11-11 23:56:18 +03:00
docs: Remove table of contents from README (#2697) * docs: Remove bad badges for black and smoke * docs: Replace the table of contents with textual description * docs: Reference -> Supplementary Documentation * docs: Remove yaml front-matter from README.md It doesn't really make a ton of sense to expose the root README as a sample. * docs: Add a callout for R samples 2023-10-25 01:39:55 +03:00			`## About This Repository`

			`The azureml-examples repository contains examples and tutorials to help you learn how to use Azure Machine Learning`
			`(Azure ML) services and features.`


			`### Getting Started`

			`If you're getting started with Azure ML, consider working through our [tutorials] for the v2 Python SDK. You may`
			`also want to read through our [documentation](#supplementary-documentation).`

			`### SDKs`

			The `sdk/` folder houses the examples for the Azure ML SDKs across several languages.

			`We have an extensive collection of examples for the [Azure ML Python SDK v2][azure cli ml extension v2 overview] in`
			[`sdk/python`][azureml python sdk v2 examples].

			`We also offer some examples for our SDKs in other languages:`

			* .NET: [`sdk/dotnet`][azureml dotnet sdk v2 examples]
			* TypeScript: [`sdk/typescript`][azureml typescript sdk v2 examples]

docs: Add missing word from README.md heading (#2758) 2023-10-25 01:50:00 +03:00			`### Azure Machine Learning extension for Azure CLI`
docs: Remove table of contents from README (#2697) * docs: Remove bad badges for black and smoke * docs: Replace the table of contents with textual description * docs: Reference -> Supplementary Documentation * docs: Remove yaml front-matter from README.md It doesn't really make a ton of sense to expose the root README as a sample. * docs: Add a callout for R samples 2023-10-25 01:39:55 +03:00
			The [`cli/` folder][azureml cli extension examples] hosts our examples to use the
docs: Add missing word from README.md heading (#2758) 2023-10-25 01:50:00 +03:00			`[Azure Machine Learning extension][azure cli ml extension v2 overview] for [Azure CLI][azure cli overview].`
docs: Remove table of contents from README (#2697) * docs: Remove bad badges for black and smoke * docs: Replace the table of contents with textual description * docs: Reference -> Supplementary Documentation * docs: Remove yaml front-matter from README.md It doesn't really make a ton of sense to expose the root README as a sample. * docs: Add a callout for R samples 2023-10-25 01:39:55 +03:00
			`_Note_: If you're looking for examples that submit Azure ML jobs that run non-Python code, see:`

			* R: [`cli/jobs/single-step/r`](./cli/jobs/single-step/r)


			`## Supplementary Documentation`

			`- [Azure Machine Learning Documentation](https://docs.microsoft.com/azure/machine-learning)`
			`- [AzureML Python SDK v2 Overview]`
docs: Add missing word from README.md heading (#2758) 2023-10-25 01:50:00 +03:00			`- [Azure CLI ML extension v2 Overview]`
readme updates; minor requirements.txt updates (#390) * saving; need to run readme * update requirements.txt; run readme.py * move contents to suffix * add blurb * minor edit 2021-03-12 23:49:12 +03:00
minor readme edits (#289) * more minor edits to readme * revert 2020-11-16 23:52:16 +03:00			`## Contributing`

			`We welcome contributions and suggestions! Please see the [contributing guidelines](CONTRIBUTING.md) for details.`

			`## Code of Conduct`

			`This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). Please see the [code of conduct](CODE_OF_CONDUCT.md) for details.`

docs: Remove table of contents from README (#2697) * docs: Remove bad badges for black and smoke * docs: Replace the table of contents with textual description * docs: Reference -> Supplementary Documentation * docs: Remove yaml front-matter from README.md It doesn't really make a ton of sense to expose the root README as a sample. * docs: Add a callout for R samples 2023-10-25 01:39:55 +03:00			`[tutorials]: ./tutorials`
			`[azure cli overview]: https://learn.microsoft.com/en-us/cli/azure/what-is-azure-cli`
			`[azureml cli extension examples]: ./cli`
			`[azureml python sdk v2 examples]: ./sdk/python`
			`[azureml dotnet sdk v2 examples]: ./sdk/dotnet`
			`[azureml typescript sdk v2 examples]: ./sdk/typescript`
			`[azure cli ml extension v2 overview]: https://learn.microsoft.com/en-us/azure/machine-learning/concept-v2?view=azureml-api-2#azure-machine-learning-cli-v2`
			`[azureml python sdk v2 overview]: https://learn.microsoft.com/en-us/azure/machine-learning/concept-v2?view=azureml-api-2#azure-machine-learning-python-sdk-v2`