Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ultralytics/hub

Ultralytics HUB tutorials and support
https://github.com/ultralytics/hub

artificial-intelligence deep-learning deploy hub machine-learning train ultralytics yolov5 yolov8

Last synced: 7 days ago
JSON representation

Ultralytics HUB tutorials and support

Host: GitHub
URL: https://github.com/ultralytics/hub
Owner: ultralytics
License: agpl-3.0
Created: 2021-11-12T14:38:47.000Z (about 3 years ago)
Default Branch: main
Last Pushed: 2024-11-21T14:52:55.000Z (about 1 month ago)
Last Synced: 2024-12-08T11:41:01.515Z (14 days ago)
Topics: artificial-intelligence, deep-learning, deploy, hub, machine-learning, train, ultralytics, yolov5, yolov8
Language: Jupyter Notebook
Homepage: https://hub.ultralytics.com
Size: 8.22 MB
Stars: 139
Watchers: 10
Forks: 14
Open Issues: 76
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        


  

    

      

  


[中文](https://docs.ultralytics.com/zh/hub/) | [한국어](https://docs.ultralytics.com/ko/hub/) | [日本語](https://docs.ultralytics.com/ja/hub/) | [Русский](https://docs.ultralytics.com/ru/hub/) | [Deutsch](https://docs.ultralytics.com/de/hub/) | [Français](https://docs.ultralytics.com/fr/hub/) | [Español](https://docs.ultralytics.com/es/hub/) | [Português](https://docs.ultralytics.com/pt/hub/) | [Türkçe](https://docs.ultralytics.com/tr/hub/) | [Tiếng Việt](https://docs.ultralytics.com/vi/hub/) | [العربية](https://docs.ultralytics.com/ar/hub/)

    

👋 Hello from the [Ultralytics](https://www.ultralytics.com/) Team! We've been working hard these last few months to launch [Ultralytics HUB](https://www.ultralytics.com/hub), a new web tool for training and deploying all your YOLOv5 and YOLOv8 🚀 models from one spot!

We hope that the resources here will help you get the most out of HUB. Please browse the HUB Docs for details, raise an issue on GitHub for support, and join our Discord community for questions and discussions!






  

  

  

  

  

  

  

  

  

  

  

  

  





## 🗂️ 1. Upload a Dataset

Ultralytics HUB datasets align with the format used by [YOLOv5](https://github.com/ultralytics/yolov5) and [YOLOv8](https://github.com/ultralytics/ultralytics). They adhere to the same structural and labeling conventions, ensuring a seamless experience.

### Dataset Preparation:

Ensure that the YAML file describing your dataset is placed in the root directory of your dataset, as illustrated below. Once in place, zip the directory for uploading to [Ultralytics HUB](https://www.ultralytics.com/hub). The dataset YAML, its directory, and the zip file should all bear the identical name.

For instance, with a dataset named 'coco8', as shown in [ultralytics/hub/example_datasets/coco8.zip](./example_datasets/coco8.zip), include a `coco8.yaml` within the `coco8/` directory. Zip this to form `coco8.zip` for upload with the command:

```bash

# Zipping the dataset directory for upload

zip -r coco8.zip coco8

```

Explore the provided [example_datasets/coco8.zip](./example_datasets/coco8.zip) for insights on structuring your custom dataset.







### YAML Specifications:

The dataset YAML follows the established YOLOv5 and YOLOv8 format. For exhaustive instructions, refer to the [Train Custom Data tutorial](https://docs.ultralytics.com/yolov5/tutorials/train_custom_data/).

```yaml

# YAML configuration example for custom datasets

path: # dataset root dir (leave empty for HUB integration)

train: images/train # train images (relative to 'path') 8 images

val: images/val # val images (relative to 'path') 8 images

test: # test images (optional)

# Class labels

names:

  0: person

  1: bicycle

  2: car

  3: motorcycle

  # Add more classes as needed

```

Upload your zipped dataset to [Ultralytics HUB](https://www.ultralytics.com/hub) by logging in, navigating to the 'Datasets' tab, and selecting 'Upload Dataset'. This lets you scan and view your dataset prior to training YOLOv5 or YOLOv8 models.



  



## 🚀 2. Train a Model

Connect to the Ultralytics HUB notebook and employ your model API key to embark on model training!



    



## 🌐 3. Deploy to the Real World

Transition your model to 13 different formats including TensorFlow, ONNX, OpenVINO, CoreML, Paddle, and more. Operate your models directly on your [iOS](https://apps.apple.com/xk/app/ultralytics/id1583935240) or [Android](https://play.google.com/store/apps/details?id=com.ultralytics.ultralytics_app) mobile device by downloading the [Ultralytics App](https://www.ultralytics.com/app-install)!

## ❓ Have Issues or Questions?

For those just embarking on their [Ultralytics HUB](https://www.ultralytics.com/hub) journey, the [Issues](https://github.com/ultralytics/hub/issues) tab is your go-to resource for support. Click the 'New Issue' button and share your thoughts or questions. Our aim is to enhance your experience with invaluable solutions and improvements! 😃