Ultralytics-Einstellungen#
Ultralytics speichert persistente, maschinenspezifische Einstellungen in einer JSON-Datei im Benutzerkonfigurationsverzeichnis und macht sie über das Objekt settings in Python und den Befehl yolo settings zugänglich. Sie steuern, wo Datensätze, Gewichte und Durchläufe gespeichert werden, den API-Schlüssel der Ultralytics Platform und welche Experiment-Tracker aktiviert sind. Laufbezogene Argumente wie imgsz und epochs werden stattdessen auf der Seite Configuration dokumentiert.
Einstellungen anzeigen, aktualisieren und zurücksetzen
from ultralytics import settings
print(settings) # view all settings
value = settings["runs_dir"] # read one setting
settings.update({"runs_dir": "/path/to/runs", "tensorboard": False}) # update one or more settings
settings.reset() # restore defaultsReferenz der Einstellungen#
| Name | Beispielwert | Datentyp | Beschreibung |
|---|---|---|---|
settings_version | '0.0.8' | str | Schemaversion der Einstellungen, unabhängig von der Paketversion ultralytics |
datasets_dir | '/path/to/datasets' | str | Verzeichnis, in dem Datensätze gespeichert werden |
weights_dir | '/path/to/weights' | str | Verzeichnis, in dem Modellgewichte gespeichert werden |
runs_dir | '/path/to/runs' | str | Verzeichnis, in dem Experimentläufe gespeichert werden |
uuid | 'a1b2c3d4' | str | Anonymisierte Maschinenkennung (SHA-256-Hash) für Analysen |
sync | True | bool | Anonymisierte Analysen und Absturzberichte an Ultralytics senden, siehe Privacy |
api_key | '' | str | API-Schlüssel für die Ultralytics Platform |
openai_api_key | '' | str | OpenAI-API-Schlüssel für die Ask-KI-Funktion des Explorer, verfügbar bis ultralytics==8.3.11 |
clearml | True | bool | ClearML-Protokollierung aktivieren |
comet | True | bool | Comet ML-Experimentverfolgung aktivieren |
dvc | True | bool | DVC-Experimentverfolgung aktivieren |
mlflow | True | bool | MLflow-Experimentverfolgung aktivieren |
raytune | True | bool | Berichterstellung für Ray Tune-hyperparameter tuning aktivieren |
tensorboard | False | bool | TensorBoard-Protokollierung aktivieren |
wandb | False | bool | Weights & Biases-Protokollierung aktivieren |
vscode_msg | True | bool | Eine Aufforderung zur Installation der Ultralytics-Snippets-Erweiterung anzeigen, wenn ein VS-Code-Terminal erkannt wird |
openvino_msg | True | bool | Auf Intel-CPUs einen Tipp anzeigen, der den OpenVINO-Export für eine schnellere Inferenz empfiehlt |