Instalar Ultralytics#

Ultralytics ofrece varios métodos de instalación, incluidos pip, conda y Docker. Puedes instalar YOLO mediante el paquete pip ultralytics para la última versión estable, o clonando el repositorio de GitHub de Ultralytics para obtener la versión más actual. Docker también es una opción para ejecutar el paquete en un contenedor aislado, lo que evita la instalación local.

# Install or upgrade the ultralytics package from PyPI
pip install -U ultralytics

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

Consulta el archivo ultralytics pyproject.toml para ver una lista de dependencias. Ten en cuenta que todos los ejemplos anteriores instalan todas las dependencias necesarias.

Consejo

Los requisitos de PyTorch varían según el sistema operativo y los requisitos de CUDA, así que instala PyTorch primero siguiendo las instrucciones en PyTorch.

Instalación en servidor headless#

Para entornos de servidor sin pantalla (por ejemplo, máquinas virtuales en la nube, contenedores de Docker, canalizaciones de CI/CD), usa el paquete ultralytics-opencv-headless. Es idéntico al paquete estándar ultralytics, pero depende de opencv-python-headless en lugar de opencv-python, lo que evita dependencias de interfaz gráfica innecesarias y posibles errores de libGL.

pip install ultralytics-opencv-headless

Ambos paquetes proporcionan la misma funcionalidad y API. La variante headless simplemente excluye los componentes de interfaz gráfica de OpenCV que requieren bibliotecas de visualización.

Instalación avanzada#

Aunque los métodos de instalación estándar cubren la mayoría de los casos de uso, es posible que necesites una configuración más personalizada para desarrollo o configuraciones específicas.

Usar Ultralytics con CLI#

La interfaz de línea de comandos (CLI) de Ultralytics permite ejecutar comandos sencillos de una sola línea sin necesidad de un entorno de Python. La CLI no requiere personalización ni código en Python; ejecuta todas las tareas desde la terminal con el comando yolo. Para más información sobre cómo usar YOLO desde la línea de comandos, consulta la Guía de CLI.

yolo TASK MODE ARGS

Guía de CLI

Usar Ultralytics con Python#

La interfaz de Python de Ultralytics YOLO ofrece una integración fluida en proyectos de Python, lo que facilita la carga, ejecución y procesamiento de las salidas del modelo. Diseñada para ser sencilla, la interfaz de Python permite a los usuarios implementar rápidamente detección de objetos, segmentación de instancias, segmentación semántica, estimación de profundidad y clasificación. Esto convierte a la interfaz de Python de YOLO en una herramienta indispensable para incorporar estas funcionalidades en proyectos de Python.

Por ejemplo, los usuarios pueden cargar un modelo, entrenarlo, evaluar su rendimiento y exportarlo al formato ONNX con tan solo unas pocas líneas de código. Explora la Guía de Python para obtener más información sobre el uso de YOLO en tus proyectos de Python.

from ultralytics import YOLO

# Create a new YOLO model from scratch
model = YOLO("yolo26n.yaml")

# Load a pretrained YOLO model (recommended for training)
model = YOLO("yolo26n.pt")

# Train the model using the 'coco8.yaml' dataset for 3 epochs
results = model.train(data="coco8.yaml", epochs=3)

# Evaluate the model's performance on the validation set
results = model.val()

# Perform object detection on an image using the model
results = model("https://ultralytics.com/images/bus.jpg")

# Export the model to ONNX format
success = model.export(format="onnx")

Guía de Python

Ajustes de Ultralytics#

La librería de Ultralytics incluye un SettingsManager para un control detallado de los experimentos, lo que permite a los usuarios acceder y modificar la configuración fácilmente. Almacenados en un archivo JSON dentro del directorio de configuración del usuario del entorno, estos ajustes se pueden ver o modificar en el entorno de Python o mediante la interfaz de línea de comandos (CLI).

Inspeccionar ajustes#

Para ver la configuración actual de tus ajustes:

from ultralytics import settings

# View all settings
print(settings)

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

Modificar ajustes#

Ultralytics facilita la modificación de los ajustes de las siguientes formas:

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()

Comprender los ajustes#

La siguiente tabla ofrece una visión general de los ajustes configurables en Ultralytics, incluyendo valores de ejemplo, tipos de datos y descripciones.

Revisa estos ajustes a medida que avances en tus proyectos o experimentos para asegurar una configuración óptima.

FAQ#

¿Cómo instalo Ultralytics usando pip?#

Instala Ultralytics con pip usando:

pip install -U ultralytics

Esto instala la última versión estable del paquete ultralytics desde PyPI. Para instalar la versión de desarrollo directamente desde GitHub:

pip install git+https://github.com/ultralytics/ultralytics.git

Asegúrate de que la herramienta de línea de comandos de Git esté instalada en tu sistema.

¿Puedo instalar Ultralytics YOLO usando conda?#

Sí, instala Ultralytics YOLO usando conda con:

conda install -c conda-forge ultralytics

Este método es una gran alternativa a pip, ya que garantiza la compatibilidad con otros paquetes. En entornos CUDA, instala ultralytics, pytorch y pytorch-cuda juntos para resolver conflictos:

conda install -c pytorch -c nvidia -c conda-forge pytorch torchvision pytorch-cuda=12.1 ultralytics

Para más instrucciones, consulta la Guía de inicio rápido de Conda.

¿Cuáles son las ventajas de usar Docker para ejecutar Ultralytics YOLO?#

Docker proporciona un entorno aislado y coherente para Ultralytics YOLO, lo que garantiza un rendimiento fluido en todos los sistemas y evita las complejidades de la instalación local. Hay imágenes oficiales de Docker disponibles en Docker Hub, con variantes para GPU, CPU, ARM64, NVIDIA Jetson y Conda. Para descargar y ejecutar la imagen más reciente:

# Pull the latest ultralytics image from Docker Hub
sudo docker pull ultralytics/ultralytics:latest

# Run the ultralytics image in a container with GPU support
sudo docker run -it --ipc=host --device nvidia.com/gpu=all ultralytics/ultralytics:latest

Para obtener instrucciones detalladas sobre Docker, consulta la Guía de inicio rápido de Docker.

¿Cómo clono el repositorio de Ultralytics para desarrollo?#

Clona el repositorio de Ultralytics y configura un entorno de desarrollo con:

# 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 .

Esto permite contribuir al proyecto o experimentar con el código fuente más reciente. Para más detalles, visita el repositorio de GitHub de Ultralytics.

¿Por qué debería usar la CLI de Ultralytics YOLO?#

La CLI de Ultralytics YOLO simplifica la ejecución de tareas de detección de objetos sin código Python, permitiendo comandos de una sola línea para entrenamiento, validación y predicción directamente desde tu terminal. La sintaxis básica es:

yolo TASK MODE ARGS

Por ejemplo, para entrenar un modelo de detección:

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

Explora más comandos y ejemplos de uso en la Guía de CLI completa.