Установите Ultralytics

Установите или обновите ultralytics пакет с помощью pip, выполнив команду pip install -U ultralytics. Для получения более подробной информации о ultralytics пакет, посетите Индекс пакетов Python (PyPI).

# Install the ultralytics package from PyPI
pip install ultralytics

Вы также можете установить ultralytics непосредственно из Ultralytics Репозиторий GitHub. Это может быть полезно, если вам нужна последняя версия разработки. Убедитесь, что у вас установлен инструмент командной строки Git, а затем выполните команду:

# Install the ultralytics package from GitHub
pip install git+https://github.com/ultralytics/ultralytics.git@main

Conda можно использовать в качестве альтернативного менеджера пакетов вместо pip. Более подробную информацию можно найти на сайте Anaconda. Репозиторий Ultralytics для обновления пакета conda доступен на GitHub.

# Install the ultralytics package using conda
conda install -c conda-forge ultralytics

# Install all packages together using conda
conda install -c pytorch -c nvidia -c conda-forge pytorch torchvision pytorch-cuda=11.8 ultralytics

Образ докера Conda

Ultralytics Образы Conda Docker также доступны с сайта DockerHub. Эти изображения основаны на Миниконда3 и предоставляют простой способ начать использовать ultralytics в среде Conda.

# Set image name as a variable
t=ultralytics/ultralytics:latest-conda

# Pull the latest ultralytics image from Docker Hub
sudo docker pull $t

# Run the ultralytics image in a container with GPU support
sudo docker run -it --ipc=host --gpus all $t            # all GPUs
sudo docker run -it --ipc=host --gpus '"device=2,3"' $t # specify GPUs

Клонировать Ultralytics Репозиторий GitHub если вы заинтересованы в участии в разработке или хотите поэкспериментировать с последним исходным кодом. После клонирования перейдите в каталог и установите пакет в режиме редактирования -e с помощью pip.

# Clone the ultralytics repository
git clone https://github.com/ultralytics/ultralytics

# Navigate to the cloned directory
cd ultralytics

# Install the package in editable mode for development
pip install -e .

Используйте Docker для выполнения ultralytics пакет в изолированном контейнере, что обеспечивает стабильную работу в различных средах. Выбрав один из официальных ultralytics изображения из Docker HubВы избегаете сложностей локальной установки и получаете доступ к проверенной рабочей среде. Ultralytics предлагает пять основных поддерживаемых образов Docker, каждый из которых разработан для высокой совместимости и эффективности:

• Dockerfile: GPU образ, рекомендуемый для обучения.
• Dockerfile-arm64: Оптимизирован для архитектуры ARM64, подходит для развертывания на таких устройствах, как Raspberry Pi и других платформах на базе ARM64.
• cpu: версия CPU на базе Ubuntu, подходящая для выводов и сред без GPU.
• Dockerfile-jetson: Предназначен для устройств NVIDIA Jetson, интегрирует поддержку GPU , оптимизированную для этих платформ.
• Dockerfile-python: Минимальный образ, содержащий только Python и необходимые зависимости, идеально подходит для легких приложений и разработки.
• Dockerfile-conda: Основано на Miniconda3 с установкой conda ultralytics пакет.

Вот команды для получения последнего образа и его выполнения:

# Set image name as a variable
t=ultralytics/ultralytics:latest

# Pull the latest ultralytics image from Docker Hub
sudo docker pull $t

# Run the ultralytics image in a container with GPU support
sudo docker run -it --ipc=host --gpus all $t            # all GPUs
sudo docker run -it --ipc=host --gpus '"device=2,3"' $t # specify GPUs

Приведенная выше команда инициализирует контейнер Docker с последней версией ultralytics изображение. Сайт -it Флаги назначают псевдо-TTY и держат stdin открытым, позволяя взаимодействовать с контейнером. Флаг --ipc=host флаг устанавливает пространство имен IPC (Inter-Process Communication) на хосте, что необходимо для разделения памяти между процессами. Флаг --gpus all флаг позволяет получить доступ ко всем доступным GPU внутри контейнера, что очень важно для задач, требующих вычислений GPU .

Примечание: Чтобы работать с файлами на локальной машине внутри контейнера, используйте тома Docker для монтирования локального каталога в контейнер:

# Mount local directory to a directory inside the container
sudo docker run -it --ipc=host --gpus all -v /path/on/host:/path/in/container $t

Заменить /path/on/host путь к каталогу на вашей локальной машине, и /path/in/container с указанием нужного пути внутри контейнера Docker.

Чтобы узнать о расширенных возможностях использования Docker, изучите руководствоUltralytics Docker Guide.

Ultralytics yolo В командах используется следующий синтаксис:

yolo TASK MODE ARGS

Смотреть все ARGS в полном Руководство по настройке или с yolo cfg CLI командование.

Обучите модель обнаружения в течение 10 эпох с начальной скоростью обучения 0,01:

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

Прогнозирование видео на YouTube с помощью предварительно обученной модели сегментации при размере изображения 320:

yolo predict model=yolo11n-seg.pt source='https://youtu.be/LNwODJXcvt4' imgsz=320

Проверьте предварительно обученную модель обнаружения с размером партии 1 и размером изображения 640:

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

Экспортируйте модель классификации YOLOv11n в формат ONNX с размером изображения 224x128 (не требуется TASK):

yolo export model=yolo11n-cls.pt format=onnx imgsz=224,128

Считайте объекты в видео или живом потоке с помощью YOLO11:

yolo solutions count show=True

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

Следите за тренировками с помощью модели позы YOLO11 :

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

Используйте YOLO11 для подсчета объектов в заданной очереди или области:

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

Выполняйте обнаружение объектов, сегментацию экземпляров или оценку позы в веб-браузере с помощью Streamlit:

yolo solutions inference

yolo solutions inference model="path/to/model.pt" # use model fine-tuned with Ultralytics Python package

Выполняйте специальные команды, чтобы узнать версию, просмотреть настройки, запустить проверки и многое другое:

yolo help
yolo checks
yolo version
yolo settings
yolo copy-cfg
yolo cfg
yolo solutions help

Используйте Python для просмотра настроек, импортировав файл settings объект из ultralytics модуль. Печать и возврат настроек с помощью этих команд:

from ultralytics import settings

# View all settings
print(settings)

# Return a specific setting
value = settings["runs_dir"]

Интерфейс командной строки позволяет проверить настройки с помощью:

yolo settings

В Python используйте update метод на settings объект:

from ultralytics import settings

# Update a setting
settings.update({"runs_dir": "/path/to/runs"})

# Update multiple settings
settings.update({"runs_dir": "/path/to/runs", "tensorboard": False})

# Reset settings to default values
settings.reset()

Чтобы изменить настройки с помощью интерфейса командной строки:

# Update a setting
yolo settings runs_dir='/path/to/runs'

# Update multiple settings
yolo settings runs_dir='/path/to/runs' tensorboard=False

# Reset settings to default values
yolo settings reset