Link to this sectionPerguntas Frequentes (FAQ) sobre o Ultralytics YOLO#
Esta seção de FAQ aborda perguntas e problemas comuns que os usuários podem encontrar ao trabalhar com os repositórios Ultralytics YOLO.
Link to this sectionFAQ#
Link to this sectionO que é a Ultralytics e o que ela oferece?#
A Ultralytics é uma empresa de IA de visão computacional especializada em modelos de detecção de objetos e segmentação de imagens de última geração, com foco na família YOLO (You Only Look Once). Suas ofertas incluem:
- Implementações de código aberto do YOLO26 (mais recente) e YOLO11 (geração anterior)
- Uma ampla gama de modelos pré-treinados para diversas tarefas de visão computacional
- Um pacote Python abrangente para a integração perfeita de modelos YOLO em projetos
- Ferramentas versáteis para treinar, testar e implementar modelos
- Documentação extensa e uma comunidade de suporte
Link to this sectionComo instalo o pacote Ultralytics?#
Instalar o pacote Ultralytics é simples usando o pip:
pip install ultralyticsPara a versão de desenvolvimento mais recente, instale diretamente do repositório GitHub:
pip install git+https://github.com/ultralytics/ultralytics.gitInstruções detalhadas de instalação podem ser encontradas no guia de início rápido.
Link to this sectionQuais são os requisitos de sistema para executar modelos Ultralytics?#
Requisitos mínimos:
- Python 3.8+
- PyTorch 1.8+
- GPU compatível com CUDA (para aceleração por GPU)
Configuração recomendada:
- Python 3.8+
- PyTorch 1.10+
- GPU NVIDIA com CUDA 11.2+
- 8GB+ de RAM
- 50GB+ de espaço livre em disco (para armazenamento de conjuntos de dados e treinamento de modelos)
Para solucionar problemas comuns, visite a página de Problemas Comuns do YOLO.
Link to this sectionComo posso treinar um modelo YOLO personalizado no meu próprio conjunto de dados?#
Para treinar um modelo YOLO personalizado:
-
Prepare seu conjunto de dados no formato YOLO (imagens e arquivos txt de rótulo correspondentes).
-
Crie um arquivo YAML descrevendo a estrutura e as classes do seu conjunto de dados (veja o exemplo de YAML de conjunto de dados).
-
Use o seguinte código Python para iniciar o treinamento:
from ultralytics import YOLO # Load a model model = YOLO("yolo26n.yaml") # build a new model from scratch model = YOLO("yolo26n.pt") # load a pretrained model (recommended for training) # Train the model results = model.train(data="path/to/your/data.yaml", epochs=100, imgsz=640)
Para um guia mais aprofundado, incluindo preparação de dados e opções avançadas de treinamento, consulte o guia de treinamento abrangente.
Link to this sectionQuais modelos pré-treinados estão disponíveis na Ultralytics?#
A Ultralytics oferece uma gama diversificada de modelos pré-treinados para várias tarefas:
- Detecção de Objetos: YOLO26n, YOLO26s, YOLO26m, YOLO26l, YOLO26x
- Segmentação de Instância: YOLO26n-seg, YOLO26s-seg, YOLO26m-seg, YOLO26l-seg, YOLO26x-seg
- Segmentação Semântica: YOLO26n-sem, YOLO26s-sem, YOLO26m-sem, YOLO26l-sem, YOLO26x-sem
- Classificação: YOLO26n-cls, YOLO26s-cls, YOLO26m-cls, YOLO26l-cls, YOLO26x-cls
- Estimativa de Pose: YOLO26n-pose, YOLO26s-pose, YOLO26m-pose, YOLO26l-pose, YOLO26x-pose
- Detecção Orientada (OBB): YOLO26n-obb, YOLO26s-obb, YOLO26m-obb, YOLO26l-obb, YOLO26x-obb
Esses modelos variam em tamanho e complexidade, oferecendo diferentes equilíbrios entre velocidade e precisão. Explore a gama completa de modelos pré-treinados para encontrar o mais adequado ao seu projeto.
Link to this sectionComo realizo a inferência usando um modelo Ultralytics treinado?#
Para realizar inferência com um modelo treinado:
from ultralytics import YOLO
# Load a model
model = YOLO("path/to/your/model.pt")
# Perform inference
results = model("path/to/image.jpg")
# Process results
for r in results:
print(r.boxes) # print bbox predictions
print(r.masks) # print mask predictions
print(r.probs) # print class probabilitiesPara opções avançadas de inferência, incluindo processamento em lote e inferência de vídeo, confira o guia de predição detalhado.
Link to this sectionOs modelos Ultralytics podem ser implantados em dispositivos de borda ou em ambientes de produção?#
Com certeza! Os modelos Ultralytics são projetados para implantação versátil em várias plataformas:
- Dispositivos de borda: Otimize a inferência em dispositivos como NVIDIA Jetson ou Intel Neural Compute Stick usando TensorRT, ONNX ou OpenVINO.
- Mobile: Faz o deploy em dispositivos Android ou iOS convertendo modelos para LiteRT ou CoreML.
- Nuvem: Aproveite frameworks como TensorFlow Serving ou PyTorch Serve para implantações em nuvem escaláveis.
- Web: Implementa a inferência no navegador usando LiteRT.js ou ONNX.js.
A Ultralytics fornece funções de exportação para converter modelos para vários formatos para implementação. Explore a ampla gama de opções de implementação para encontrar a melhor solução para o seu caso de uso.
Link to this sectionQual é a diferença entre YOLO11 e YOLO26?#
As principais distinções incluem:
- Inferência End-to-End Sem NMS: O YOLO26 é nativamente end-to-end, produzindo predições diretamente sem non-maximum suppression (NMS), reduzindo a latência e simplificando a implantação.
- Remoção de DFL: O YOLO26 remove o módulo Distribution Focal Loss, simplificando a exportação e melhorando a compatibilidade com dispositivos de borda e de baixo consumo de energia.
- Otimizador MuSGD: Um híbrido de SGD e Muon (inspirado no Kimi K2 da Moonshot AI) para um treinamento mais estável e convergência mais rápida.
- Desempenho de CPU: O YOLO26 entrega uma inferência em CPU até 43% mais rápida, tornando-o ideal para dispositivos sem GPUs.
- Otimizações Específicas de Tarefa: Segmentação aprimorada com perda semântica e protos multiescala, RLE para estimativa de pose de precisão e decodificação OBB aprimorada com perda de ângulo.
- Tarefas: Ambos os modelos suportam detecção de objetos e segmentação de instância, enquanto o YOLO26 também adiciona segmentação semântica para predição densa em nível de pixel. Ambos os modelos também suportam classificação, estimativa de pose e detecção de objetos orientados (OBB) em uma estrutura unificada.
Para uma comparação detalhada de recursos e métricas de desempenho, visite a página de documentação do YOLO26.
Link to this sectionComo posso contribuir para o projeto de código aberto da Ultralytics?#
Contribuir para a Ultralytics é uma ótima maneira de melhorar o projeto e expandir suas habilidades. Veja como você pode participar:
- Faça um fork do repositório da Ultralytics no GitHub.
- Crie um novo branch para sua funcionalidade ou correção de bug.
- Faça suas alterações e garanta que todos os testes passem.
- Envie um pull request com uma descrição clara das suas alterações.
- Participe do processo de revisão de código.
Você também pode contribuir relatando bugs, sugerindo recursos ou melhorando a documentação. Para diretrizes detalhadas e melhores práticas, consulte o guia de contribuição.
Link to this sectionComo instalo o pacote Ultralytics em Python?#
Instalar o pacote Ultralytics em Python é simples. Use o pip executando o seguinte comando no seu terminal ou prompt de comando:
pip install ultralyticsPara a versão de desenvolvimento de ponta, instale diretamente do repositório GitHub:
pip install git+https://github.com/ultralytics/ultralytics.gitPara instruções de instalação específicas do ambiente e dicas de solução de problemas, consulte o guia de início rápido abrangente.
Link to this sectionQuais são os principais recursos do Ultralytics YOLO?#
O Ultralytics YOLO possui um rico conjunto de recursos para tarefas avançadas de visão computacional:
- Detecção em Tempo Real: Detecte e classifique objetos de forma eficiente em cenários de tempo real.
- Capacidades Multitarefa: Realize detecção de objetos, segmentação de instância, segmentação semântica, classificação, estimativa de pose e detecção de objetos orientados (OBB) com uma estrutura unificada.
- Modelos Pré-treinados: Acesse uma variedade de modelos pré-treinados que equilibram velocidade e precisão para diferentes casos de uso.
- Treinamento Personalizado: Ajuste facilmente modelos em conjuntos de dados personalizados com o pipeline de treinamento flexível.
- Amplas Opções de Implementação: Exporte modelos para vários formatos como TensorRT, ONNX e CoreML para implementação em diferentes plataformas.
- Documentação Extensa: Beneficie-se da documentação abrangente e de uma comunidade de suporte para seus fluxos de trabalho de visão computacional.
Link to this sectionComo posso melhorar o desempenho do meu modelo YOLO?#
Aprimorar o desempenho do seu modelo YOLO pode ser feito por meio de várias técnicas:
- Ajuste de Hiperparâmetros: Experimente diferentes hiperparâmetros usando o Guia de Ajuste de Hiperparâmetros para otimizar o desempenho do modelo.
- Aumento de Dados: Implemente técnicas como inverter, escalar, girar e ajustes de cor para aprimorar seu conjunto de dados de treinamento e melhorar a generalização do modelo.
- Transfer Learning: Aproveite modelos pré-treinados e faça o ajuste fino deles no seu conjunto de dados específico usando o Guia de Treinamento.
- Exportação para Formatos Eficientes: Converta seu modelo para formatos otimizados como TensorRT ou ONNX para uma inferência mais rápida usando o Guia de Exportação.
- Benchmarking: Utilize o Modo Benchmark para medir e melhorar a velocidade e a precisão da inferência de forma sistemática.
Link to this sectionPosso implantar modelos Ultralytics YOLO em dispositivos móveis e de borda?#
Sim, os modelos Ultralytics YOLO são projetados para implantação versátil, incluindo dispositivos móveis e de borda:
- Mobile: Converte modelos para LiteRT ou CoreML para uma integração perfeita em aplicações Android ou iOS. Consulta o LiteRT Integration Guide e o CoreML Integration Guide para instruções específicas de cada plataforma.
- Dispositivos de Borda: Otimize a inferência em dispositivos como NVIDIA Jetson ou outro hardware de borda usando TensorRT ou ONNX. O Guia de Integração Edge TPU fornece etapas detalhadas para implementação na borda.
Para uma visão geral abrangente das estratégias de implementação em várias plataformas, consulte o guia de opções de implementação.
Link to this sectionComo posso realizar a inferência usando um modelo Ultralytics YOLO treinado?#
Realizar inferência com um modelo Ultralytics YOLO treinado é simples:
-
Carregar o Modelo:
from ultralytics import YOLO model = YOLO("path/to/your/model.pt") -
Executar Inferência:
results = model("path/to/image.jpg") for r in results: print(r.boxes) # print bounding box predictions print(r.masks) # print mask predictions print(r.probs) # print class probabilities
Para técnicas avançadas de inferência, incluindo processamento em lote, inferência de vídeo e pré-processamento personalizado, consulte o guia de predição detalhado.
Link to this sectionOnde posso encontrar exemplos e tutoriais para usar a Ultralytics?#
A Ultralytics oferece uma riqueza de recursos para ajudar você a começar e dominar suas ferramentas:
- 📚 Documentação oficial: Guias abrangentes, referências de API e melhores práticas.
- 💻 Repositório GitHub: Código-fonte, scripts de exemplo e contribuições da comunidade.
- ✍️ Blog da Ultralytics: Artigos aprofundados, casos de uso e percepções técnicas.
- 💬 Fóruns da comunidade: Conecta-te com outros utilizadores, faz perguntas e partilha as tuas experiências.
- 🎥 Canal do YouTube: Tutoriais em vídeo, demonstrações e webinars sobre vários tópicos da Ultralytics.
Estes recursos fornecem exemplos de código, casos de uso reais e guias passo a passo para várias tarefas usando modelos da Ultralytics.
Se precisares de mais assistência, consulta a documentação da Ultralytics ou entra em contacto com a comunidade através de GitHub Issues ou do fórum de discussão oficial.