Installa Ultralytics#

Ultralytics offre una varietà di metodi di installazione, inclusi pip, conda e Docker. Puoi installare YOLO tramite il pacchetto pip ultralytics per la versione stabile più recente, oppure clonando il repository GitHub di Ultralytics per la versione più aggiornata. Docker è anche un'opzione per eseguire il pacchetto in un contenitore isolato, evitando l'installazione locale.

# 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 il file ultralytics pyproject.toml per un elenco delle dipendenze. Nota che tutti gli esempi sopra installano tutte le dipendenze richieste.

Suggerimento

I requisiti di PyTorch variano in base al sistema operativo e ai requisiti CUDA, quindi installa prima PyTorch seguendo le istruzioni su PyTorch.

Installazione su server headless#

Per ambienti server senza schermo (ad es. VM cloud, contenitori Docker, pipeline CI/CD), usa il pacchetto ultralytics-opencv-headless. Questo è identico al pacchetto standard ultralytics ma dipende da opencv-python-headless anziché da opencv-python, evitando dipendenze GUI non necessarie e potenziali errori libGL.

pip install ultralytics-opencv-headless

Entrambi i pacchetti forniscono la stessa funzionalità e API. La variante headless esclude semplicemente i componenti GUI di OpenCV che richiedono librerie di visualizzazione.

Installazione avanzata#

Sebbene i metodi di installazione standard coprano la maggior parte dei casi d'uso, potresti aver bisogno di una configurazione più su misura per lo sviluppo o configurazioni personalizzate.

Usa Ultralytics con la CLI#

L'interfaccia a riga di comando (CLI) di Ultralytics consente semplici comandi su singola riga senza la necessità di un ambiente Python. La CLI non richiede alcuna personalizzazione o codice Python; esegui tutte le attività dal terminale con il comando yolo. Per saperne di più sull'uso di YOLO dalla riga di comando, consulta la Guida CLI.

yolo TASK MODE ARGS

Guida CLI

Usa Ultralytics con Python#

L'interfaccia Python di Ultralytics YOLO offre un'integrazione perfetta nei progetti Python, facilitando il caricamento, l'esecuzione e l'elaborazione degli output dei modelli. Progettata per la semplicità, l'interfaccia Python consente agli utenti di implementare rapidamente rilevamento di oggetti, segmentazione di istanze, segmentazione semantica, stima della profondità e classificazione. Ciò rende l'interfaccia Python di YOLO uno strumento prezioso per incorporare queste funzionalità nei progetti Python.

Ad esempio, gli utenti possono caricare un modello, addestrarlo, valutarne le prestazioni ed esportarlo nel formato ONNX con poche righe di codice. Esplora la Guida Python per saperne di più sull'uso di YOLO all'interno dei tuoi progetti 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")

Guida Python

Impostazioni di Ultralytics#

La libreria Ultralytics include un SettingsManager per un controllo granulare sugli esperimenti, consentendo agli utenti di accedere e modificare facilmente le impostazioni. Memorizzate in un file JSON all'interno della directory di configurazione utente dell'ambiente, queste impostazioni possono essere visualizzate o modificate nell'ambiente Python o tramite l'interfaccia a riga di comando (CLI).

Ispezione delle impostazioni#

Per visualizzare la configurazione corrente delle tue impostazioni:

from ultralytics import settings

# View all settings
print(settings)

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

Modifica delle impostazioni#

Ultralytics rende facile modificare le impostazioni nei seguenti modi:

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

Comprendere le impostazioni#

La tabella seguente offre una panoramica delle impostazioni regolabili all'interno di Ultralytics, inclusi valori di esempio, tipi di dati e descrizioni.

Rivedi queste impostazioni man mano che avanzi nei progetti o negli esperimenti per garantire una configurazione ottimale.

FAQ#

Come installo Ultralytics usando pip?#

Installa Ultralytics con pip usando:

pip install -U ultralytics

Questo installa l'ultima versione stabile del pacchetto ultralytics da PyPI. Per installare la versione di sviluppo direttamente da GitHub:

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

Assicurati che lo strumento da riga di comando Git sia installato sul tuo sistema.

Posso installare Ultralytics YOLO usando conda?#

Sì, installa Ultralytics YOLO usando conda con:

conda install -c conda-forge ultralytics

Questo metodo è un'ottima alternativa a pip, garantendo la compatibilità con altri pacchetti. Per ambienti CUDA, installa ultralytics, pytorch e pytorch-cuda insieme per risolvere i conflitti:

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

Per ulteriori istruzioni, consulta la Guida rapida a Conda.

Quali sono i vantaggi dell'utilizzo di Docker per eseguire Ultralytics YOLO?#

Docker fornisce un ambiente isolato e coerente per Ultralytics YOLO, garantendo prestazioni fluide tra i sistemi ed evitando le complessità dell'installazione locale. Le immagini Docker ufficiali sono disponibili su Docker Hub, con varianti per GPU, CPU, ARM64, NVIDIA Jetson e Conda. Per scaricare ed eseguire l'immagine più recente:

# 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

Per istruzioni dettagliate su Docker, consulta la Guida rapida a Docker.

Come clono il repository Ultralytics per lo sviluppo?#

Clona il repository Ultralytics e configura un ambiente di sviluppo 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 .

Ciò consente di contribuire al progetto o di sperimentare con il codice sorgente più recente. Per i dettagli, visita il repository GitHub di Ultralytics.

Perché dovrei usare la CLI di Ultralytics YOLO?#

La CLI di Ultralytics YOLO semplifica l'esecuzione di attività di rilevamento oggetti senza codice Python, consentendo comandi su riga singola per addestramento, convalida e previsione direttamente dal tuo terminale. La sintassi di base è:

yolo TASK MODE ARGS

Ad esempio, per addestrare un modello di rilevamento:

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

Esplora altri comandi ed esempi di utilizzo nella Guida CLI completa.