Configuración de Ultralytics#
Ultralytics guarda la configuración persistente de cada máquina en un archivo JSON del directorio de configuración del usuario y la expone mediante el objeto settings en Python y el comando yolo settings. Esta configuración controla dónde se guardan los conjuntos de datos, los pesos y las ejecuciones, la clave de API de Ultralytics Platform y qué sistemas de seguimiento de experimentos están habilitados. Los argumentos específicos de cada ejecución, como imgsz y epochs, se documentan en la página de Configuración.
Ver, actualizar y restablecer la configuración
from ultralytics import settings
print(settings) # ver toda la configuración
value = settings["runs_dir"] # leer un ajuste
settings.update({"runs_dir": "/path/to/runs", "tensorboard": False}) # actualizar uno o varios ajustes
settings.reset() # restablecer los valores predeterminadosReferencia de configuración#
| Nombre | Valor de ejemplo | Tipo de dato | Descripción |
|---|---|---|---|
settings_version | '0.0.8' | str | Versión del esquema de configuración, distinta de la versión del paquete ultralytics |
datasets_dir | '/path/to/datasets' | str | Directorio donde se almacenan los conjuntos de datos |
weights_dir | '/path/to/weights' | str | Directorio donde se almacenan los pesos de los modelos |
runs_dir | '/path/to/runs' | str | Directorio donde se almacenan las ejecuciones de experimentos |
uuid | 'a1b2c3d4' | str | Identificador anónimo de la máquina (hash SHA-256) utilizado para el análisis |
sync | True | bool | Enviar datos de análisis anonimizados e informes de fallos a Ultralytics; consulta Privacidad |
api_key | '' | str | Clave de API de Ultralytics Platform |
openai_api_key | '' | str | Clave de API de OpenAI para la función Ask AI de Explorer, disponible hasta ultralytics==8.3.11 |
clearml | True | bool | Habilitar el registro de ClearML |
comet | True | bool | Habilitar el seguimiento de experimentos de Comet ML |
dvc | True | bool | Habilitar el seguimiento de experimentos de DVC |
mlflow | True | bool | Habilitar el seguimiento de experimentos de MLflow |
raytune | True | bool | Habilitar los informes de ajuste de hiperparámetros de Ray Tune |
tensorboard | False | bool | Habilitar el registro de TensorBoard |
wandb | False | bool | Habilitar el registro de Weights & Biases |
vscode_msg | True | bool | Mostrar un aviso para instalar la extensión Ultralytics-Snippets cuando se detecte un terminal de VS Code |
openvino_msg | True | bool | En las CPU Intel, mostrar un consejo que recomiende exportar a OpenVINO para acelerar la inferencia |