Projects

Ultralytics Platform projects provide an effective solution for organizing and managing your models. Group related models together to facilitate easier management, comparison, and development.

graph TB
    P[Project] --> M1[Model 1]
    P --> M2[Model 2]
    P --> M3[Model 3]
    M1 --> C[Charts Dashboard]
    M2 --> C
    M3 --> C
    M1 --> T[Comparison Table]
    M2 --> T
    M3 --> T

    style P fill:#4CAF50,color:#fff
    style C fill:#2196F3,color:#fff
    style T fill:#FF9800,color:#fff

Create Project

Navigate to Projects in the sidebar and click Create Project.

Enter your project details:

• Name: A descriptive name for your project (a random name is auto-generated)
• Description: Optional notes about the project purpose
• Visibility: Public (anyone can view) or Private (only you can access)
• License: Optional license for your project (AGPL-3.0, Apache-2.0, MIT, GPL-3.0, BSD-3-Clause, LGPL-3.0, MPL-2.0, EUPL-1.1, Unlicense, Ultralytics-Enterprise, and more)

Click Create to finalize. Your new project appears in the Projects list and sidebar.

Project Page

The project page has two main areas:

Project Header

The header displays:

• Project icon (customizable color, letter, or uploaded image)
• Editable name (click to rename; slug auto-updates)
• License badge
• Model count, completed/running/failed counts, total size
• Clone count and last updated timestamp
• Description (click to edit)

Action buttons in the header:

View Modes

Toggle between two view modes using the view controls:

• Charts view: Interactive charts dashboard showing loss curves and metric comparisons for selected models
• Table view: Comparison table showing training arguments and final metrics side-by-side with a diff mode to highlight differing columns

Models Sidebar

The resizable sidebar lists all models in the project:

• Checkboxes to select which models appear in charts/table
• Search to filter models by name
• View options for status filter (All, Completed, Running, Starting, Pending, Failed, Cancelled), grouping by task, and sort order
• Drag and drop .pt files directly onto the sidebar to upload models (model upload details)
• Training progress shown for running models (epoch count and progress bar)

Click any model to open its model page.

Project Icon

Customize your project icon:

1. Click the icon next to the project name
2. Choose a color and letter, or upload a custom image
3. Changes save automatically

Visibility Settings

Control who can see your project:

Share with Collaborators

Share private projects with other users:

1. Click the Share button on the project page
2. Enter the collaborator's username or email
3. Set their role
4. Click Invite

Collaborators with editor access can upload models and start training within your project. See Teams for role permissions.

Clone Project

Clone a public project to your own account:

1. Visit the public project page
2. Click Clone Project
3. The project and all its models are copied to your account as a private project

Compare Models

Charts Dashboard

Compare model performance using the charts dashboard:

1. Select models in the sidebar using checkboxes
2. View overlaid metric curves grouped by type (metrics, train loss, validation loss, learning rate)
3. Drag charts to rearrange, resize by dragging edges
4. Hover to see exact values, click legend items to hide/show models, click a model line to navigate to that model

Available chart groups:

Comparison Table

Switch to table view for side-by-side comparison of training arguments and final metrics:

1. Click the Table view mode toggle
2. See all selected models as rows with training args and metrics as columns
3. Use the Diff button to highlight only columns where values differ across models

Upload Models

Upload existing .pt model files:

1. Drag and drop files onto the project page or models sidebar
2. Multiple files can be uploaded simultaneously (up to 3 concurrent uploads)
3. Model metadata (task, architecture, class names, training results) is parsed automatically from the .pt file
4. Charts update instantly from locally parsed data while the upload completes in the background

Edit Project

Update project name, description, or settings:

1. Click the project name to edit it inline
2. Click the description to edit it inline
3. Click the icon to customize it
4. Click the license badge to change the license

Delete Project

Remove a project you no longer need:

1. Click the Delete button (trash icon) in the header
2. Confirm deletion

FAQ

How many models can a project contain?

There's no hard limit on models per project. However, for better organization, we recommend:

• Group related experiments (same dataset/task)
• Archive old experiments
• Use meaningful project names

Can I restore a deleted project?

Yes, deleted projects go to Trash and can be restored within 30 days:

1. Go to Settings > Trash
2. Find the project
3. Click Restore

Can I transfer models between projects?

Yes, you can clone a model to a different project using the clone model dialog from the model page.

📅 Created 1 month ago ✏️ Updated 7 days ago

Comments