コマンドラインインターフェース

Ultralyticsコマンドラインインターフェース(CLI)は、Python環境を必要とせずにUltralytics YOLOモデルを使用するための簡単な方法を提供します。CLIは、yoloコマンドを使用してターミナルから直接さまざまなタスクを実行することをサポートしており、カスタマイズやPythonコードは不要です。



Watch: Mastering Ultralytics YOLO: CLI

Ultralyticsのyoloコマンドは、以下の構文を使用します。

yolo TASK MODE ARGS

各引数の説明:

  • TASK(オプション)は [detect, segment, classify, pose, obb, semantic] のいずれかです。
  • MODE(必須)は [train, val, predict, export, track, benchmark] のいずれかです。
  • ARGS (optional) are any number of custom arg=value pairs like imgsz=320 that override defaults.

すべてのARGSについては、完全なConfiguration Guideを参照するか、yolo cfgコマンドで確認してください。

各引数の説明:

  • TASK(オプション)は [detect, segment, classify, pose, obb, semantic] のいずれかです。明示的に渡されない場合、YOLOはモデルタイプからTASKの推論を試みます。
  • MODE(必須)は [train, val, predict, export, track, benchmark] のいずれかです。
  • ARGS (optional) are any number of custom arg=value pairs like imgsz=320 that override defaults. For a full list of available ARGS, see the Configuration page and default.yaml.
警告

Arguments must be passed as arg=val pairs, separated by an equals = sign and delimited by spaces between pairs. Do not use -- argument prefixes or commas , between 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

学習(Train)

COCO8データセットでYOLOを100エポック、画像サイズ640で学習させます。利用可能な引数の全リストについては、Configurationページを参照してください。

YOLO26nをCOCO8で100エポック、画像サイズ640で学習開始します。

yolo detect train data=coco8.yaml model=yolo26n.pt epochs=100 imgsz=640

検証(Val)

学習済みモデルのaccuracyをCOCO8データセットで検証します。modelは学習時のdataや引数をモデル属性として保持しているため、引数は不要です。

公式のYOLO26nモデルを検証します。

yolo detect val model=yolo26n.pt

予測

学習済みモデルを使用して画像に対して推論を実行します。

公式のYOLO26nモデルで推論を実行します。

yolo detect predict model=yolo26n.pt source='https://ultralytics.com/images/bus.jpg'

エクスポート(Export)

モデルをONNXやCoreMLなどの異なる形式にエクスポートします。

公式のYOLO26nモデルをONNX形式にエクスポートします。

yolo export model=yolo26n.pt format=onnx

利用可能なUltralyticsのエクスポート形式は以下の表の通りです。format引数を使用して任意の形式にエクスポートできます(例: format='onnx' または format='engine')。

形式format 引数モデルメタデータ引数
PyTorch-yolo26n.pt-
TorchScripttorchscriptyolo26n.torchscriptimgsz, half, dynamic, optimize, nms, batch, device
ONNXonnxyolo26n.onnximgsz, half, dynamic, simplify, opset, nms, batch, device
OpenVINOopenvinoyolo26n_openvino_model/imgsz, half, dynamic, int8, nms, batch, data, fraction, device
TensorRTengineyolo26n.engineimgsz, half, dynamic, simplify, workspace, int8, nms, batch, data, fraction, device
CoreMLcoremlyolo26n.mlpackageimgsz, dynamic, half, int8, nms, batch, device
TF SavedModelsaved_modelyolo26n_saved_model/imgsz, keras, int8, nms, batch, data, fraction, device
TF GraphDefpbyolo26n.pbimgsz, batch, device
TF Litetfliteyolo26n.tfliteimgsz, half, int8, nms, batch, data, fraction, device
TF Edge TPUedgetpuyolo26n_edgetpu.tfliteimgsz, int8, data, fraction, device
TF.jstfjsyolo26n_web_model/imgsz, half, int8, nms, batch, data, fraction, device
PaddlePaddlepaddleyolo26n_paddle_model/imgsz, batch, device
MNNmnnyolo26n.mnnimgsz, batch, int8, half, device
NCNNncnnyolo26n_ncnn_model/imgsz, half, batch, device
IMX500imxyolo26n_imx_model/imgsz, int8, data, fraction, nms, device
RKNNrknnyolo26n_rknn_model/imgsz, batch, name, device
ExecuTorchexecutorchyolo26n_executorch_model/imgsz, batch, device
Axeleraaxelerayolo26n_axelera_model/imgsz, batch, int8, data, fraction, device
DeepXdeepxyolo26n_deepx_model/imgsz, int8, data, optimize, device

export の詳細については、Export ページを参照してください。

デフォルト引数の上書き

デフォルトの引数を上書きするには、CLI で arg=value ペアとして渡します。

ヒント

学習率 0.01 で検出モデルを 10 エポック学習させる場合:

yolo detect train data=coco8.yaml model=yolo26n.pt epochs=10 lr0=0.01

デフォルト設定ファイルの上書き

Override the default.yaml configuration file entirely by passing a new file with the cfg argument, such as cfg=custom.yaml.

To do this, first create a copy of default.yaml in your current working directory with the yolo copy-cfg command, which creates a default_copy.yaml file.

次に、このファイルを cfg=default_copy.yaml として渡し、この例のように imgsz=320 などの追加引数を指定できます。

yolo copy-cfg
yolo cfg=default_copy.yaml imgsz=320

ソリューションコマンド

Ultralytics は、CLI を通じて一般的なコンピュータビジョンアプリケーション向けのすぐに使えるソリューションを提供します。yolo solutions コマンドを使用すると、オブジェクトのカウント、クロップ、ぼかし、ワークアウト監視、ヒートマップ、インスタンスセグメンテーション、VisionEye、速度推定、キュー管理、分析、Streamlit 推論、およびゾーンベースの追跡機能が利用可能です。カタログの全容については Solutions ページを参照してください。サポートされているすべてのソリューションとその引数を一覧表示するには yolo solutions help を実行してください。

動画やライブストリーム内のオブジェクトをカウントします:

yolo solutions count show=True
yolo solutions count source="path/to/video.mp4" # specify video file path

Ultralytics ソリューションの詳細については、Solutions ページを参照してください。

FAQ

モデルの学習に Ultralytics YOLO コマンドラインインターフェース (CLI) を使用するにはどうすればよいですか?

CLI を使用してモデルを学習させるには、ターミナルで 1 行のコマンドを実行します。例えば、学習率 0.01 で 10 エポック検出モデルを学習させるには、以下を実行します:

yolo train data=coco8.yaml model=yolo26n.pt epochs=10 lr0=0.01

このコマンドは、特定の引数を指定して train モードを使用します。利用可能な引数の完全なリストについては、Configuration Guide を参照してください。

Ultralytics YOLO CLI でどのようなタスクを実行できますか?

Ultralytics YOLO CLI は、detectionsegmentationclassificationpose estimationoriented bounding box detectionsemantic segmentation を含む様々なタスクをサポートしています。また、以下の操作も可能です:

  • モデルの学習: yolo train data=<data.yaml> model=<model.pt> epochs=<num> を実行します。
  • 予測の実行: yolo predict model=<model.pt> source=<data_source> imgsz=<image_size> を使用します。
  • モデルのエクスポート: yolo export model=<model.pt> format=<export_format> を実行します。
  • ソリューションの使用: すぐに使えるアプリケーションとして yolo solutions <solution_name> を実行します。

様々な引数で各タスクをカスタマイズできます。詳細な構文と例については、TrainPredictExport などの各セクションを参照してください。

CLI を使用して学習済み YOLO モデルの精度を検証するにはどうすればよいですか?

モデルの 精度 を検証するには、val モードを使用します。例えば、バッチサイズ 1、画像サイズ 640 で事前学習済み検出モデルを検証するには、以下を実行します:

yolo val model=yolo26n.pt data=coco8.yaml batch=1 imgsz=640

このコマンドは、指定されたデータセットでモデルを評価し、mAPprecisionrecall などのパフォーマンス指標を提供します。詳細については、Val セクションを参照してください。

CLI を使用して YOLO モデルをどのフォーマットにエクスポートできますか?

YOLO モデルを ONNX、TensorRT、CoreML、TensorFlow など、様々なフォーマットにエクスポートできます。例えば、モデルを ONNX フォーマットにエクスポートするには、以下を実行します:

yolo export model=yolo26n.pt format=onnx

エクスポートコマンドは、特定のデプロイメント環境に合わせてモデルを最適化するための多数のオプションをサポートしています。利用可能なすべてのエクスポートフォーマットとその特定のパラメータに関する詳細については、Export ページを参照してください。

Ultralytics CLI の構築済みソリューションを使用するにはどうすればよいですか?

Ultralytics は solutions コマンドを通じてすぐに使えるソリューションを提供しています。例えば、動画内のオブジェクトをカウントするには:

yolo solutions count source="path/to/video.mp4"

これらのソリューションは最小限の設定で済み、一般的なコンピュータビジョンタスクに対して即座に機能を提供します。利用可能なすべてのソリューションを確認するには、yolo solutions help を実行してください。各ソリューションには、ニーズに合わせてカスタマイズ可能な特定のパラメータがあります。

コメント