docs/en/platform/quickstart.md
Ultralytics Platform is designed to be user-friendly and intuitive, allowing users to quickly upload their datasets and train new YOLO models. It offers a range of pretrained models to choose from, making it easy for users to get started. Once a model is trained, it can be tested directly in the browser and deployed to production with a single click.
<p align="center"> <iframe loading="lazy" width="720" height="405" src="https://www.youtube.com/embed/VGa3HMUWQSM" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen> </iframe><strong>Watch:</strong> Get Started with Ultralytics Platform - QuickStart
</p>The following interactive diagram outlines the four primary stages of the Ultralytics Platform workflow. Click any stage or sub-step to access detailed instructions for that section.
graph LR
A(Sign Up) --> B(Prepare Data) --> C(Train) --> D(Deploy)
A -.- A1["<a href='#get-started'>Create account</a>
<a href='#region-selection'>Select region</a>"]
B -.- B1["<a href='#upload-your-first-dataset'>Upload dataset</a>
<a href='#create-your-first-project'>Create Project</a>"]
C -.- C1["<a href='#training-configuration'>Configure training</a>
<a href='#monitor-training'>Monitor progress</a>"]
D -.- D1["<a href='#test-your-model'>Test model</a>
<a href='#deploy-to-production'>Deploy endpoint</a>"]
click A "#get-started"
click B "#upload-your-first-dataset"
click C "#train-your-first-model"
click D "#deploy-to-production"
Ultralytics Platform offers a variety of easy signup options. You can register and log in using your Google or GitHub accounts, or with your email address.
During onboarding, you'll be asked to select your data region. The Platform automatically measures latency to each region and recommends the closest one. This is an important choice as it determines where your data, models, and deployments will be stored.
| Region | Label | Location | Best For |
|---|---|---|---|
| US | Americas | Iowa, USA | Americas users, fastest for Americas |
| EU | Europe, Middle East & Africa | Belgium, Europe | European users, GDPR compliance |
| AP | Asia Pacific | Taiwan, Asia-Pacific | Asia-Pacific users, lowest APAC latency |
!!! warning "Region is Permanent"
Your region selection cannot be changed after account creation. Choose the region closest to you or your users for best performance.
Every new account receives free credits for cloud GPU training:
| Email Type | Sign-up Credits | How to Qualify |
|---|---|---|
| Work/Company Email | $25.00 | Use your company domain (@company.com) |
| Personal Email | $5.00 | Gmail, Yahoo, Outlook, etc. |
!!! tip "Maximize Your Credits"
Sign up with a work email to receive $25 in credits. If you signed up with a personal email, you can verify a work email later to unlock the additional $20 in credits.
The onboarding flow guides you through three steps:
??? tip "Update Later"
You can update your profile anytime from [Settings](account/settings.md), including your display name, bio, and social links. Note that your username and data region cannot be changed after signup.
After signing in, you will be directed to the Home page of Ultralytics Platform, which provides a welcome card with workspace stats, quick access to datasets, projects, and storage, and a recent activity feed.
The sidebar provides access to all Platform sections:
| Section | Item | Description |
|---|---|---|
| Top | Search | Quick search across all your resources (Cmd+K) |
| Home | Dashboard with quick actions and recent activity | |
| Explore | Discover public projects and datasets | |
| My Projects | Annotate | Your datasets organized for annotation |
| Train | Your projects containing trained models | |
| Deploy | Your active deployments | |
| Bottom | Trash | Deleted items (recoverable for 30 days) |
| Settings | Account, billing, and preferences | |
| Help | Open help, docs, and feedback tools |
The welcome card shows your profile, plan badge, and workspace statistics at a glance:
| Stat | Description |
|---|---|
| Datasets | Number of datasets |
| Images | Total images across all datasets |
| Annotations | Total annotation count |
| Projects | Number of projects |
| Models | Total trained models |
| Exports | Number of model exports |
| Deployments | Active deployment count |
Below the welcome card, the dashboard shows three cards:
.pt model files to upload. Shows your recent projects.A Recent Activity table at the bottom shows your latest datasets, models, and training runs.
Press Cmd+K (Mac) or Ctrl+K (Windows/Linux) to open the search bar. Search across pages, projects, datasets, and deployments instantly.
A floating chat widget is available on every page. Click it to ask questions about YOLO training, annotation, deployment, or any Platform feature. The assistant provides context-aware help based on the current page.
The Platform includes guided tours that introduce key features as you explore different sections:
| Tour | Trigger | What It Covers |
|---|---|---|
| Nav Tour | First visit to Home after onboarding | Home, Explore, Annotate, Train, Deploy, Settings, Account |
| Project Tour | First visit to a project page | Models sidebar, Training Charts, Train button |
| Dataset Tour | First visit to a dataset page | Images gallery, Split tabs, Classes, Charts, Train, Upload, Download |
!!! tip "Enterprise Users"
Enterprise plan users see an enhanced Nav Tour with enterprise-specific guidance on the Train step.
To replay any tour:
platform.ultralytics.com/home?tour=nav to restart the Nav Tour directly.Navigate to Annotate in the sidebar and click New Dataset to add your training data. You can also drag and drop files directly onto the Datasets card on the Home dashboard.
Ultralytics Platform supports multiple upload formats (full details in Datasets):
| Format | Max Size (Free / Pro / Enterprise) | Description |
|---|---|---|
| Images | 50 MB | JPG, PNG, WebP, TIFF, and other common formats |
| Dataset Archive | 10 / 20 / 50 GB | ZIP or TAR archive (including .tar.gz and .tgz) with images and labels |
| Video | 1 GB | MP4, WebM, MOV, AVI, MKV, M4V - frames extracted at ~1 fps (max 100 frames) |
| NDJSON | 10 / 20 / 50 GB | Ultralytics dataset export format for portable metadata |
graph LR
A[Drop Files] --> B[Auto-Package ZIP]
B --> C[Upload to Storage]
C --> D[Backend Worker]
D --> E[Resize & Thumbnail]
E --> F[Parse Labels]
F --> G[Compute Statistics]
G --> H[Dataset Ready]
After upload, the platform automatically processes your data:
.txt format)!!! tip "YOLO Dataset Structure"
For best results, upload a ZIP or TAR archive (including `.tar.gz` and `.tgz`) with the standard YOLO structure:
```
my-dataset.zip
├── data.yaml # Class names and splits
├── train/
│ ├── images/
│ │ ├── img001.jpg
│ │ └── img002.jpg
│ └── labels/
│ ├── img001.txt
│ └── img002.txt
└── val/
├── images/
└── labels/
```
For full syntax across tasks, see [detect](../datasets/detect/index.md#ultralytics-yolo-format), [segment](../datasets/segment/index.md#ultralytics-yolo-format), [pose](../datasets/pose/index.md#ultralytics-yolo-format), [OBB](../datasets/obb/index.md#yolo-obb-format), and [classify](../datasets/classify/index.md#dataset-structure-for-yolo-classification-tasks) dataset guides.
Read more about datasets and supported formats for detect, segment, pose, OBB, and classify.
Projects help you organize related models and experiments. Navigate to Projects and click "Create Project".
Enter a name and optional description for your project. Projects contain:
Read more about projects.
From your project, click Train Model to start cloud training.
train split are shown)!!! warning "Credit Balance Required"
Cloud training requires a positive credit balance sufficient to cover the estimated job cost. Check your balance in [`Settings > Billing`](account/billing.md). New accounts receive free credits ($5 for personal email, $25 for work email).
Once training starts, you can monitor progress in real-time through three subtabs:
| Subtab | Content |
|---|---|
| Charts | Training/validation loss curves, mAP, precision, recall |
| Console | Live training log output |
| System | GPU utilization, memory usage, hardware metrics |
Metrics are streamed in real-time via SSE (Server-Sent Events). After training completes, validation plots are generated including confusion matrix, PR curves, and F1 curves.
!!! tip "Cancel Training"
You can cancel a running training job at any time. You're only charged for the compute time used up to that point.
Read more about cloud training.
After training completes, test your model directly in the browser:
Predict tabAdjust inference parameters:
| Parameter | Default | Description |
|---|---|---|
| Confidence | 0.25 | Filter low-confidence predictions |
| IoU | 0.7 | Control overlap for NMS |
| Image Size | 640 | Resize input for inference |
The Predict tab provides ready-to-use code examples with your actual API key pre-filled:
=== "Python"
```python
import requests
url = "https://platform.ultralytics.com/api/models/{model_id}/predict"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
with open("image.jpg", "rb") as f:
response = requests.post(url, headers=headers, files={"file": f})
print(response.json())
```
=== "cURL"
```bash
curl -X POST "https://platform.ultralytics.com/api/models/{model_id}/predict" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "[email protected]"
```
!!! tip "Auto-Inference"
The Predict tab runs inference automatically when you drop an image — no need to click a button. Example images (bus.jpg, zidane.jpg) are preloaded for instant testing.
Read more about inference.
Deploy your model to a dedicated endpoint for production use:
Deploy tabDeploy to create your endpointgraph LR
A[Select Region] --> B[Deploy]
B --> C[Provisioning ~1 min]
C --> D[Running]
D --> E{Lifecycle}
E --> F[Stop]
E --> G[Delete]
F --> H[Resume]
H --> D
Your endpoint will be ready in about a minute with:
!!! info "Deployment Lifecycle"
Endpoints can be **started**, **stopped**, and **deleted**. Stopped endpoints don't incur compute costs but retain their configuration. Restart a stopped endpoint with one click.
After deployment, you can manage all your endpoints from the Deploy section in the sidebar, which shows a global map with active deployments, overview metrics, and a list of all endpoints.
Read more about endpoints.
If you prefer to train on your own hardware, you can stream metrics to the platform using your API key. This works like Weights & Biases — train anywhere, monitor on the platform.
Settings > API Keysproject/name format:export ULTRALYTICS_API_KEY="YOUR_API_KEY"
yolo train model=yolo26n.pt data=coco.yaml epochs=100 project=username/my-project name=exp1
!!! note "API Key Format"
API keys start with `ul_` followed by 40 hex characters (43 characters total). Keys are full-access tokens scoped to your workspace.
Read more about API keys, dataset URIs, and remote training.
The Help page in the sidebar footer includes an in-app feedback form. You can rate your experience, choose a feedback type (bug, feature request, or general), and attach screenshots.
If you need more help: