Installa Ultralytics#
Installa il pacchetto ultralytics con pip, conda o Docker, oppure dai sorgenti, quindi esegui la tua prima predizione con un modello YOLO26 preaddestrato. Ciascun metodo installa tutte le dipendenze richieste elencate in pyproject.toml.
Installa o aggiorna il pacchetto ultralytics in un ambiente Python>=3.8 con PyTorch>=1.8:
pip install -U ultralyticsPer l'ultima versione di sviluppo, installa direttamente dal repository GitHub di Ultralytics:
pip install git+https://github.com/ultralytics/ultralytics.git@mainI requisiti di PyTorch variano in base al sistema operativo e alla versione di CUDA. Per utilizzare una build specifica, installa prima PyTorch seguendo le istruzioni di installazione di PyTorch, quindi installa ultralytics.
Usa Ultralytics con la CLI#
Esegui la tua prima predizione dal terminale con il comando yolo:
yolo predict model=yolo26n.ptI pesi preaddestrati di yolo26n.pt vengono scaricati automaticamente, il modello viene eseguito su due immagini campione incluse e il comando stampa dove ha salvato i risultati annotati, runs/detect/predict al primo avvio. Punta source alla tua immagine, video, directory, URL o flusso, oppure a una webcam con source=0:
yolo predict model=yolo26n.pt source=0 show=Truepredict è la modalità, ovvero cosa fare con il modello: train, val, predict, export, track o benchmark. Il task (detect, segment, semantic, depth, classify, pose o obb) viene letto dal file del modello, quindi la sintassi di yolo TASK MODE ARGS solitamente richiede solo la modalità più coppie arg=value come imgsz=640. Consulta la Guida CLI per ogni modalità e la pagina di Configurazione per tutti gli argomenti.
Usa Ultralytics con Python#
La stessa predizione in Python:
from ultralytics import YOLO
model = YOLO("yolo26n.pt") # load a pretrained YOLO26n detection model
results = model("https://ultralytics.com/images/bus.jpg", save=True) # predict and save the annotated imageresults è un elenco di oggetti Results, uno per immagine, contenente box, maschere, keypoint o probabilità di classe a seconda del task. La Guida Python copre addestramento, validazione, export e tracciamento con la stessa classe YOLO.
Watch: Ultralytics YOLO Quick Start Guide
Impostazioni di Ultralytics#
Le impostazioni persistenti come le directory dei dataset, dei pesi e delle esecuzioni, la chiave API della Piattaforma Ultralytics e gli interruttori del logger degli esperimenti si trovano in un file JSON gestito con yolo settings. Consulta la pagina Impostazioni per visualizzarle, modificarle o ripristinarle.
E adesso?#
Sfoglia le modalità in cui YOLO viene eseguito e le dimensioni dei modelli YOLO26, quindi addestra sui tuoi dati dopo averli formattati con la Guida ai dataset.
Per uno sguardo al futuro, esplora YOLO27 (In arrivo). I suoi modelli non sono ancora disponibili; gli esempi precedenti utilizzano la famiglia YOLO26 rilasciata.
FAQ#
Installa Ultralytics con pip usando:
pip install -U ultralyticsQuesto installa l'ultima versione stabile del pacchetto
ultralyticsda PyPI. Per installare la versione di sviluppo direttamente da GitHub:pip install git+https://github.com/ultralytics/ultralytics.gitAssicurati che lo strumento da riga di comando Git sia installato sul tuo sistema.
Sì, installa Ultralytics YOLO usando conda con:
conda install -c conda-forge ultralyticsQuesto metodo è un'ottima alternativa a pip, garantendo la compatibilità con altri pacchetti. Per gli ambienti CUDA, installa
ultralyticsinsieme al metapacchettopytorch-gpuin modo che conda selezioni una build di PyTorch abilitata per CUDA:conda install -c conda-forge ultralytics pytorch-gpuPer ulteriori istruzioni, consulta la Guida rapida a Conda.
Docker fornisce un ambiente isolato e coerente per Ultralytics YOLO, garantendo prestazioni fluide tra i vari sistemi ed evitando la 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'ultima immagine:
# 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:latestSu Linux, le richieste di dispositivi CDI richiedono Docker >= 28.2.0 e NVIDIA Container Toolkit >= 1.18. Per istruzioni dettagliate su Docker, consulta la guida di avvio rapido di Docker.
Clona il repository di 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 contributi al progetto o sperimentazioni con l'ultimo codice sorgente. Per i fork e la fijazione di un branch personalizzato, consulta l'Installazione di sviluppo.
La CLI di Ultralytics YOLO semplifica l'esecuzione di attività di rilevamento oggetti senza codice Python, consentendo comandi su singola riga per l'addestramento, la validazione e la predizione direttamente dal tuo terminale. La sintassi di base è:
yolo TASK MODE ARGSAd esempio, per addestrare un modello di rilevamento:
yolo train data=coco8.yaml model=yolo26n.pt epochs=10 lr0=0.01Esplora altri comandi ed esempi d'uso nella Guida CLI completa.