Interface de ligne de commande#
L'interface en ligne de commande (CLI) d'Ultralytics offre un moyen simple d'utiliser les modèles Ultralytics YOLO sans nécessiter d'environnement Python. La CLI prend en charge l'exécution de diverses tâches directement depuis le terminal à l'aide de la commande yolo, sans nécessiter de personnalisation ni de code Python.
Watch: Mastering Ultralytics YOLO: CLI
Les commandes Ultralytics yolo utilisent la syntaxe suivante :
yolo TASK MODE ARGSOù :
TASK(facultatif) fait partie de [detect, segment, semantic, depth, classify, pose, obb]MODE(obligatoire) fait partie de [train, val, predict, export, track, benchmark]ARGS(facultatif) correspond à un nombre quelconque de paires personnaliséesarg=valuetelles queimgsz=320qui remplacent les valeurs par défaut.
Retrouve tous les arguments ARGS dans le Guide de configuration complet ou avec yolo cfg.
Où :
TASK(facultatif) fait partie de[detect, segment, semantic, depth, classify, pose, obb]. S'il n'est pas explicitement transmis, YOLO tentera de déduireTASKà partir du type de modèle.MODE(obligatoire) fait partie de[train, val, predict, export, track, benchmark]ARGS(facultatif) correspond à un nombre quelconque de paires personnaliséesarg=valuetelles queimgsz=320qui remplacent les valeurs par défaut. Pour obtenir la liste complète desARGSdisponibles, consulte la page Configuration etdefault.yaml.
Les arguments doivent être transmis sous forme de paires arg=val, séparées par un signe égal = et délimitées par des espaces entre les paires. N'utilise pas de préfixes d'arguments -- ni de virgules , entre les arguments.
yolo predict model=yolo26n.pt imgsz=640 conf=0.25✅yolo predict model yolo26n.pt imgsz 640 conf 0.25❌yolo predict --model yolo26n.pt --imgsz 640 --conf 0.25❌
Entraîner (Train)#
Entraîne YOLO sur le jeu de données COCO8 pendant 100 époques avec une taille d'image de 640. Pour obtenir une liste complète des arguments disponibles, consulte la page Configuration.
Lance l'entraînement de YOLO26n sur COCO8 pendant 100 epochs avec une taille d'image de 640 :
yolo detect train data=coco8.yaml model=yolo26n.pt epochs=100 imgsz=640Valider (Val)#
Valide la précision du modèle entraîné sur le jeu de données COCO8. Aucun argument n'est nécessaire car model conserve son data d'entraînement et ses arguments en tant qu'attributs du modèle.
Valide un modèle YOLO26n officiel :
yolo detect val model=yolo26n.ptPrédire (Predict)#
Utilise un modèle entraîné pour effectuer des prédictions sur des images.
Prédit avec un modèle YOLO26n officiel :
yolo detect predict model=yolo26n.pt source='https://ultralytics.com/images/bus.jpg'Exporter (Export)#
Exporte un modèle vers un format différent comme ONNX ou CoreML.
Exporte un modèle YOLO26n officiel au format ONNX :
yolo export model=yolo26n.pt format=onnxLes formats d'exportation Ultralytics disponibles se trouvent dans le tableau ci-dessous. Tu peux exporter vers n'importe quel format à l'aide de l'argument format, c'est-à-dire format='onnx' ou format='engine'.
| Format | Argument format | Modèle | Métadonnées | Arguments |
|---|---|---|---|---|
| PyTorch | - | yolo26n.pt | ✅ | - |
| TorchScript | torchscript | yolo26n.torchscript | ✅ | imgsz, quantize, dynamic, nms, batch, device |
| ONNX | onnx | yolo26n.onnx | ✅ | imgsz, quantize, dynamic, simplify, opset, nms, batch, data, fraction, device |
| OpenVINO | openvino | yolo26n_openvino_model/ | ✅ | imgsz, quantize, dynamic, nms, batch, data, fraction, device |
| TensorRT | engine | yolo26n.engine | ✅ | imgsz, quantize, dynamic, simplify, opset, workspace, nms, batch, data, fraction, device |
| CoreML | coreml | yolo26n.mlpackage | ✅ | imgsz, dynamic, quantize, nms, batch, device |
| TF SavedModel | saved_model | yolo26n_saved_model/ | ✅ | imgsz, keras, quantize, opset, nms, batch, data, fraction, device |
| TF GraphDef | pb | yolo26n.pb | ❌ | imgsz, opset, batch, device |
| TF Edge TPU | edgetpu | yolo26n_edgetpu.tflite | ✅ | imgsz, quantize, opset, data, fraction, device |
| PaddlePaddle | paddle | yolo26n_paddle_model/ | ✅ | imgsz, batch, device |
| MNN | mnn | yolo26n.mnn | ✅ | imgsz, batch, dynamic, quantize, simplify, opset, nms, device |
| NCNN | ncnn | yolo26n_ncnn_model/ | ✅ | imgsz, quantize, batch, device |
| IMX500 | imx | yolo26n_imx_model/ | ✅ | imgsz, quantize, data, fraction, nms, device |
| RKNN | rknn | yolo26n_rknn_model/ | ✅ | imgsz, batch, name, quantize, simplify, opset, data, fraction, device |
| ExecuTorch | executorch | yolo26n_executorch_model/ | ✅ | imgsz, batch, device |
| Axelera | axelera | yolo26n_axelera_model/ | ✅ | imgsz, batch, quantize, data, fraction, device |
| DEEPX | deepx | yolo26n_deepx_model/ | ✅ | imgsz, quantize, simplify, opset, data, optimize, device |
| Qualcomm QNN | qnn | yolo26n_qnn.onnx | ✅ | imgsz, batch, name, quantize, simplify, opset, data, fraction, device |
| LiteRT | litert | yolo26n.tflite | ✅ | imgsz, quantize, batch, data, fraction, device |
| Hailo | hailo | yolo26n_hailo_model/ | ✅ | imgsz, name, quantize, data, fraction, simplify, conf, iou |
| Huawei Ascend | ascend | yolo26n_ascend_model/ | ✅ | imgsz, batch, name, quantize, opset, simplify, nms |
| Apple Core AI | coreai | yolo26n.aimodel | ✅ | imgsz, batch, quantize |
Retrouve tous les détails concernant export sur la page Exportation.
Remplacement des arguments par défaut#
Remplace les arguments par défaut en les transmettant dans la CLI sous forme de paires arg=value.
Entraîne un modèle de détection pendant 10 epochs avec un taux d'apprentissage de 0,01 :
yolo detect train data=coco8.yaml model=yolo26n.pt epochs=10 lr0=0.01Remplacement du fichier de configuration par défaut#
Remplace entièrement le fichier de configuration default.yaml en transmettant un nouveau fichier avec l'argument cfg, tel que cfg=custom.yaml.
Pour ce faire, crée d'abord une copie de default.yaml dans ton répertoire de travail actuel avec la commande yolo copy-cfg, ce qui crée un fichier default_copy.yaml.
Tu peux ensuite passer ce fichier comme cfg=default_copy.yaml ainsi que tout argument supplémentaire, tel que imgsz=320 dans cet exemple :
yolo copy-cfg
yolo cfg=default_copy.yaml imgsz=320Commandes de solutions#
Ultralytics propose des solutions prêtes à l'emploi pour les applications de vision par ordinateur courantes via la CLI. La commande yolo solutions expose le comptage d'objets, le rognage, le floutage, le suivi d'entraînement, les cartes de chaleur, la segmentation d'instances, VisionEye, l'estimation de vitesse, la gestion de files d'attente, l'analytique, l'inférence Streamlit et le suivi basé sur des zones — consulte la page Solutions pour le catalogue complet. Exécute yolo solutions help pour lister toutes les solutions prises en charge et leurs arguments.
Compte les objets dans une vidéo ou un flux en direct :
yolo solutions count show=True
yolo solutions count source="path/to/video.mp4" # specify video file pathPour plus d'informations sur les solutions Ultralytics, visite la page Solutions.
FAQ#
La CLI d'Ultralytics YOLO prend en charge diverses tâches, notamment la détection, la segmentation, la segmentation sémantique, l'estimation de la profondeur, la classification, l'estimation de pose et la détection de boîtes englobantes orientées. Tu peux également effectuer des opérations telles que :
- Entraîner un modèle : Exécute
yolo train data=<data.yaml> model=<model.pt> epochs=<num>. - Lancer des prédictions : Utilise
yolo predict model=<model.pt> source=<data_source> imgsz=<image_size>. - Exporter un modèle : Exécute
yolo export model=<model.pt> format=<export_format>. - Utiliser les solutions : Exécute
yolo solutions <solution_name>pour des applications prêtes à l'emploi.
Personnalise chaque tâche avec divers arguments. Pour une syntaxe détaillée et des exemples, consulte les sections respectives telles que Train, Predict et Export.
- Entraîner un modèle : Exécute
Pour valider la précision d'un modèle, utilise le mode
val. Par exemple, pour valider un modèle de détection pré-entraîné avec une taille de lot de 1 et une taille d'image de 640, exécute :yolo val model=yolo26n.pt data=coco8.yaml batch=1 imgsz=640Cette commande évalue le modèle sur le jeu de données spécifié et fournit des métriques de performance telles que le mAP, la précision et le rappel. Pour plus de détails, réfère-toi à la section Val.
Tu peux exporter les modèles YOLO vers divers formats, notamment ONNX, TensorRT, CoreML, TensorFlow, et plus encore. Par exemple, pour exporter un modèle au format ONNX, exécute :
yolo export model=yolo26n.pt format=onnxLa commande d'exportation prend en charge de nombreuses options pour optimiser ton modèle pour des environnements de déploiement spécifiques. Pour des détails complets sur tous les formats d'exportation disponibles et leurs paramètres spécifiques, visite la page Export.
Ultralytics propose des solutions prêtes à l'emploi via la commande
solutions. Par exemple, pour compter des objets dans une vidéo :yolo solutions count source="path/to/video.mp4"Ces solutions nécessitent une configuration minimale et offrent une fonctionnalité immédiate pour les tâches courantes de vision par ordinateur. Pour voir toutes les solutions disponibles, exécute
yolo solutions help. Chaque solution possède des paramètres spécifiques qui peuvent être personnalisés pour répondre à tes besoins.
Pour entraîner un modèle à l'aide de la CLI, exécute une commande sur une seule ligne dans le terminal. Par exemple, pour entraîner un modèle de détection pendant 10 époques avec un taux d'apprentissage de 0,01, exécute :
Cette commande utilise le mode
trainavec des arguments spécifiques. Pour obtenir une liste complète des arguments disponibles, consulte le Guide de configuration.