docs/en/guides/azureml-quickstart.md
Azure is Microsoft's cloud computing platform, designed to help organizations move their workloads to the cloud from on-premises data centers. With the full spectrum of cloud services including those for computing, databases, analytics, machine learning, and networking, users can pick and choose from these services to develop and scale new applications, or run existing applications, in the public cloud.
Azure Machine Learning (AzureML) is a fully managed cloud service for building, training, and deploying machine learning models at scale. It provides automated machine learning, drag-and-drop model training, and a Python SDK for full programmatic control over your models.
AzureML lets you train and deploy Ultralytics YOLO26 models in the cloud, from quick prototypes to large-scale runs. With it you can:
In the subsequent sections, you will find a quickstart guide detailing how to run YOLO26 object detection models using AzureML, either from a compute terminal or a notebook.
Before you can get started, make sure you have access to an AzureML workspace. If you don't have one, you can create a new AzureML workspace by following Azure's official documentation. This workspace acts as a centralized place to manage all AzureML resources.
From your AzureML workspace, select Compute > Compute instances > New, select the instance with the resources you need.
<p align="center"> </p>Start your compute and open a Terminal:
<p align="center"> </p>Create a conda virtual environment and install pip in it:
conda create --name yolo26env -y python=3.12
conda activate yolo26env
conda install pip -y
!!! warning "Python version"
Python 3.13 currently has dependency issues on AzureML, so use Python 3.12 instead.
Install the required dependencies:
pip install ultralytics onnx
yolo predict model=yolo26n.pt source='https://ultralytics.com/images/bus.jpg'
Train a detection model for 10 epochs with an initial learning_rate of 0.01:
yolo train data=coco8.yaml model=yolo26n.pt epochs=10 lr0=0.01
You can find more instructions to use the Ultralytics CLI here.
Open the compute Terminal.
<p align="center"> </p>From your compute terminal, create a new ipykernel using Python 3.12 that will be used by your notebook to manage dependencies:
conda create --name yolo26env -y python=3.12
conda activate yolo26env
conda install pip -y
conda install ipykernel -y
python -m ipykernel install --user --name yolo26env --display-name "yolo26env"
Close your terminal and create a new notebook. From your notebook, select the newly created kernel.
Then open a notebook cell and install the required dependencies:
%%bash
source activate yolo26env
pip install ultralytics onnx
!!! note "Activate the environment in every cell"
Run `source activate yolo26env` at the top of every `%%bash` cell so the cell uses the intended environment.
Run some predictions using the Ultralytics CLI:
%%bash
source activate yolo26env
yolo predict model=yolo26n.pt source='https://ultralytics.com/images/bus.jpg'
Or with the Ultralytics Python interface, for example to train the model:
from ultralytics import YOLO
# Load a model
model = YOLO("yolo26n.pt") # load an official YOLO26n model
# Use the model
model.train(data="coco8.yaml", epochs=3) # train the model
metrics = model.val() # evaluate model performance on the validation set
results = model("https://ultralytics.com/images/bus.jpg") # predict on an image
path = model.export(format="onnx") # export the model to ONNX format
You can use either the Ultralytics CLI or Python interface to run YOLO26 tasks. The Python example above also exports the trained model to ONNX for deployment.
By following these steps, you can get YOLO26 running quickly on AzureML. For more advanced workflows, see the AzureML documentation.
This guide covers the basics of running YOLO26 on AzureML. To go further, explore these resources:
To run YOLO26 on AzureML for training, create a compute instance, set up a Conda environment, install Ultralytics, and run the training command:
Create a Compute Instance: From your AzureML workspace, navigate to Compute > Compute instances > New, and select the required instance.
Set Up the Environment: Start your compute instance, open a terminal, and create a Conda environment with Python 3.12 (Python 3.13 currently has dependency issues on AzureML):
conda create --name yolo26env -y python=3.12
conda activate yolo26env
conda install pip -y
pip install ultralytics onnx
Run YOLO26 Tasks: Use the Ultralytics CLI to train your model:
yolo train data=coco8.yaml model=yolo26n.pt epochs=10 lr0=0.01
For more details, you can refer to the instructions to use the Ultralytics CLI.
AzureML provides a robust and efficient ecosystem for training YOLO26 models:
These advantages make AzureML an ideal platform for projects ranging from quick prototypes to large-scale deployments. For more tips, check out AzureML Jobs.
To troubleshoot YOLO26 on AzureML, verify your dependencies are installed, confirm your Conda environment is activated, and ensure your compute instance has enough resources:
pip install ultralytics onnx.For additional guidance, review our YOLO Common Issues documentation.
Yes, AzureML allows you to use both the Ultralytics CLI and the Python interface seamlessly:
CLI: Ideal for quick tasks and running standard scripts directly from the terminal.
yolo predict model=yolo26n.pt source='https://ultralytics.com/images/bus.jpg'
Python Interface: Useful for more complex tasks requiring custom coding and integration within notebooks.
from ultralytics import YOLO
model = YOLO("yolo26n.pt")
model.train(data="coco8.yaml", epochs=3)
For step-by-step instructions, refer to the CLI quickstart guide and the Python quickstart guide.
Ultralytics YOLO26 offers several unique advantages over competing object detection models:
To explore more about YOLO26's features, visit the Ultralytics YOLO page for detailed insights.