Interface de Linha de Comando
A interface de linha de comando (CLI) Ultralytics fornece uma maneira direta de usar os modelos Ultralytics YOLO sem precisar de um ambiente Python. A CLI oferece suporte à execução de várias tarefas diretamente do terminal usando o yolo comando, não exigindo personalização ou código Python.
Assista: Dominando Ultralytics YOLO: CLI
Exemplo
Ultralytics yolo comandos usam a seguinte sintaxe:
yolo TASK MODE ARGS
Onde:
- TASK (opcional) é um de [detect, segment, classify, pose, obb]
- MODE (obrigatório) é um de [train, val, predict, export, track, benchmark]
- ARGS (opcional) são qualquer número de arg=value pares como imgsz=320 que substituem os padrões.
Veja todos os ARGS no Guia de Configuração ou com yolo cfg.
Treine um modelo de detecção por 10 épocas com uma taxa de aprendizado inicial de 0,01:
yolo train data=coco8.yaml model=yolo11n.pt epochs=10 lr0=0.01
Preveja usando um modelo de segmentação pré-treinado em um vídeo do YouTube no tamanho de imagem 320:
yolo predict model=yolo11n-seg.pt source='https://youtu.be/LNwODJXcvt4' imgsz=320
Validar um modelo de detecção pré-treinado com um tamanho de lote de 1 e tamanho de imagem de 640:
yolo val model=yolo11n.pt data=coco8.yaml batch=1 imgsz=640
Exporte um modelo de classificação YOLO para o formato ONNX com tamanho de imagem de 224x128 (sem necessidade de TASK):
yolo export model=yolo11n-cls.pt format=onnx imgsz=224,128
Execute comandos especiais para visualizar a versão, as configurações, executar verificações e muito mais:
yolo help
yolo checks
yolo version
yolo settings
yolo copy-cfg
yolo cfg
Onde:
TASK(opcional) é um de[detect, segment, classify, pose, obb]. Se não for explicitamente passado, o YOLO tentará inferir oTASKa partir do tipo de modelo.MODE(obrigatório) é um de[train, val, predict, export, track, benchmark]ARGS(opcional) são qualquer número dearg=valuepares comoimgsz=320personalizados que substituem os padrões. Para uma lista completa deARGS, veja o Configuração página edefaults.yaml.
Aviso
Os argumentos devem ser passados como arg=val pares, separados por um sinal de igual = e delimitados por espaços entre os pares. Não use -- prefixos de argumentos ou vírgulas , entre os argumentos.
yolo predict model=yolo11n.pt imgsz=640 conf=0.25✅yolo predict model yolo11n.pt imgsz 640 conf 0.25❌yolo predict --model yolo11n.pt --imgsz 640 --conf 0.25❌
Treinar
Treine o YOLO no conjunto de dados COCO8 por 100 épocas no tamanho de imagem 640. Para uma lista completa de argumentos disponíveis, consulte a página de Configuração.
Exemplo
Comece a treinar o YOLO11n no COCO8 por 100 épocas no tamanho de imagem 640:
yolo detect train data=coco8.yaml model=yolo11n.pt epochs=100 imgsz=640
Retomar uma sessão de treinamento interrompida:
yolo detect train resume model=last.pt
Validar
Validar o precisão do modelo treinado no conjunto de dados COCO8. Nenhum argumento é necessário, pois o model mantém seu treinamento data e argumentos como atributos do modelo.
Exemplo
Validar um modelo YOLO11n oficial:
yolo detect val model=yolo11n.pt
Validar um modelo treinado personalizado:
yolo detect val model=path/to/best.pt
Prever
Use um modelo treinado para executar previsões em imagens.
Exemplo
Preveja com um modelo YOLO11n oficial:
yolo detect predict model=yolo11n.pt source='https://ultralytics.com/images/bus.jpg'
Preveja com um modelo personalizado:
yolo detect predict model=path/to/best.pt source='https://ultralytics.com/images/bus.jpg'
Exportar
Exporte um modelo para um formato diferente, como ONNX ou CoreML.
Exemplo
Exporte um modelo YOLO11n oficial para o formato ONNX:
yolo export model=yolo11n.pt format=onnx
Exporte um modelo treinado personalizado para o formato ONNX:
yolo export model=path/to/best.pt format=onnx
Os formatos de exportação Ultralytics disponíveis estão na tabela abaixo. Você pode exportar para qualquer formato usando o format argumento, ou seja, format='onnx' ou format='engine'.
| Formato | format Argumento |
Modelo | Metadados | Argumentos |
|---|---|---|---|---|
| PyTorch | - | yolo11n.pt |
✅ | - |
| TorchScript | torchscript |
yolo11n.torchscript |
✅ | imgsz, half, optimize, nms, batch, device |
| ONNX | onnx |
yolo11n.onnx |
✅ | imgsz, half, dynamic, simplify, opset, nms, batch, device |
| OpenVINO | openvino |
yolo11n_openvino_model/ |
✅ | imgsz, half, dynamic, int8, nms, batch, data, fraction, device |
| TensorRT | engine |
yolo11n.engine |
✅ | imgsz, half, dynamic, simplify, workspace, int8, nms, batch, data, fraction, device |
| CoreML | coreml |
yolo11n.mlpackage |
✅ | imgsz, half, int8, nms, batch, device |
| TF SavedModel | saved_model |
yolo11n_saved_model/ |
✅ | imgsz, keras, int8, nms, batch, device |
| TF GraphDef | pb |
yolo11n.pb |
❌ | imgsz, batch, device |
| TF Lite | tflite |
yolo11n.tflite |
✅ | imgsz, half, int8, nms, batch, data, fraction, device |
| TF Edge TPU | edgetpu |
yolo11n_edgetpu.tflite |
✅ | imgsz, device |
| TF.js | tfjs |
yolo11n_web_model/ |
✅ | imgsz, half, int8, nms, batch, device |
| PaddlePaddle | paddle |
yolo11n_paddle_model/ |
✅ | imgsz, batch, device |
| MNN | mnn |
yolo11n.mnn |
✅ | imgsz, batch, int8, half, device |
| NCNN | ncnn |
yolo11n_ncnn_model/ |
✅ | imgsz, half, batch, device |
| IMX500 | imx |
yolo11n_imx_model/ |
✅ | imgsz, int8, data, fraction, device |
| RKNN | rknn |
yolo11n_rknn_model/ |
✅ | imgsz, batch, name, device |
Veja todos os detalhes do modo export detalhes sobre o Exportar página.
Substituindo Argumentos Padrão
Substitua os argumentos padrão, passando-os na CLI como arg=value pares.
Dica
Treine um modelo de detecção por 10 épocas com uma taxa de aprendizado de 0,01:
yolo detect train data=coco8.yaml model=yolo11n.pt epochs=10 lr0=0.01
Preveja usando um modelo de segmentação pré-treinado em um vídeo do YouTube no tamanho de imagem 320:
yolo segment predict model=yolo11n-seg.pt source='https://youtu.be/LNwODJXcvt4' imgsz=320
Validar um modelo de detecção pré-treinado com um tamanho de lote de 1 e tamanho de imagem de 640:
yolo detect val model=yolo11n.pt data=coco8.yaml batch=1 imgsz=640
Substituindo o Arquivo de Configuração Padrão
Substitua o default.yaml arquivo de configuração completamente, passando um novo arquivo com o cfg argumento, como cfg=custom.yaml.
Para fazer isso, primeiro crie uma cópia de default.yaml no seu diretório de trabalho atual com o yolo copy-cfg comando, que cria um default_copy.yaml ficheiro.
Você pode então passar este arquivo como cfg=default_copy.yaml juntamente com quaisquer argumentos adicionais, como imgsz=320 neste exemplo:
Exemplo
yolo copy-cfg
yolo cfg=default_copy.yaml imgsz=320
Comandos de Soluções
A Ultralytics fornece soluções prontas para uso para aplicações comuns de visão computacional através da CLI. Essas soluções simplificam a implementação de tarefas complexas como contagem de objetos, monitoramento de exercícios e gerenciamento de filas.
Exemplo
Contar objetos em um vídeo ou transmissão ao vivo:
yolo solutions count show=True
yolo solutions count source="path/to/video.mp4" # specify video file path
Monitore os exercícios de treino usando um modelo de pose:
yolo solutions workout show=True
yolo solutions workout source="path/to/video.mp4" # specify video file path
# Use keypoints for ab-workouts
yolo solutions workout kpts=[5, 11, 13] # left side
yolo solutions workout kpts=[6, 12, 14] # right side
Contar objetos em uma fila ou região designada:
yolo solutions queue show=True
yolo solutions queue source="path/to/video.mp4" # specify video file path
yolo solutions queue region="[(20, 400), (1080, 400), (1080, 360), (20, 360)]" # configure queue coordinates
Realize detecção de objetos, segmentação de instâncias ou estimativa de pose em um navegador da web usando Streamlit:
yolo solutions inference
yolo solutions inference model="path/to/model.pt" # use custom model
Veja as soluções disponíveis e suas opções:
yolo solutions help
Para obter mais informações sobre as soluções Ultralytics, visite a página Soluções.
FAQ
Como uso a interface de linha de comando (CLI) Ultralytics YOLO para treinamento de modelo?
Para treinar um modelo usando a CLI, execute um comando de linha única no terminal. Por exemplo, para treinar um modelo de detecção por 10 épocas com uma taxa de aprendizado de 0,01, execute:
yolo train data=coco8.yaml model=yolo11n.pt epochs=10 lr0=0.01
Este comando usa o train modo com argumentos específicos. Para obter uma lista completa dos argumentos disponíveis, consulte o Guia de Configuração.
Quais tarefas posso realizar com a CLI do Ultralytics YOLO?
A Ultralytics YOLO CLI suporta várias tarefas, incluindo detecção, segmentação, classificação, estimativa de pose e detecção de caixa delimitadora orientada. Você também pode realizar operações como:
- Treinar um Modelo: Executar
yolo train data=<data.yaml> model=<model.pt> epochs=<num>. - Executar Predições: Use
yolo predict model=<model.pt> source=<data_source> imgsz=<image_size>. - Exportar um Modelo: Executar
yolo export model=<model.pt> format=<export_format>. - Use Soluções: Executar
yolo solutions <solution_name>para aplicações prontas.
Personalize cada tarefa com vários argumentos. Para sintaxe e exemplos detalhados, consulte as seções respectivas, como Train, Predict e Export.
Como posso validar a precisão de um modelo YOLO treinado usando a CLI?
Para validar a precisão, use o val modo. Por exemplo, para validar um modelo de detecção pré-treinado com um tamanho de lote de 1 e um tamanho de imagem de 640, execute:
yolo val model=yolo11n.pt data=coco8.yaml batch=1 imgsz=640
Este comando avalia o modelo no conjunto de dados especificado e fornece métricas de desempenho como mAP, precisão e recall. Para mais detalhes, consulte a seção Val.
Para quais formatos posso exportar meus modelos YOLO usando a CLI?
Você pode exportar modelos YOLO para vários formatos, incluindo ONNX, TensorRT, CoreML, TensorFlow e muito mais. Por exemplo, para exportar um modelo para o formato ONNX, execute:
yolo export model=yolo11n.pt format=onnx
O comando de exportação oferece suporte a várias opções para otimizar seu modelo para ambientes de implantação específicos. Para detalhes completos sobre todos os formatos de exportação disponíveis e seus parâmetros específicos, visite a página Export.
Como uso as soluções pré-construídas na CLI Ultralytics?
A Ultralytics fornece soluções prontas para uso através da solutions comando. Por exemplo, para contar objetos em um vídeo:
yolo solutions count source="path/to/video.mp4"
Essas soluções exigem configuração mínima e fornecem funcionalidade imediata para tarefas comuns de visão computacional. Para ver todas as soluções disponíveis, execute yolo solutions help. Cada solução tem parâmetros específicos que podem ser personalizados para atender às suas necessidades.
