Projetos#
Os projetos do Ultralytics Platform fornecem uma solução eficaz para organizar e gerenciar os teus modelos. Agrupa modelos relacionados para facilitar a gestão, comparação e o desenvolvimento.
graph TB
P[Project]:::start --> M1[Model 1]:::proc
P --> M2[Model 2]:::proc
P --> M3[Model 3]:::proc
M1 --> C[Charts Dashboard]:::out
M2 --> C
M3 --> C
M1 --> T[Comparison Table]:::out
M2 --> T
M3 --> T
classDef start fill:#4CAF50,color:#fff
classDef proc fill:#2196F3,color:#fff
classDef out fill:#9C27B0,color:#fffCriar Projeto#
Navega até Projetos na barra lateral e clica em Novo Projeto.

Criação Rápida
Também podes criar um projeto a partir das ações rápidas na página Inicial.
Insere os detalhes do teu projeto:
- Nome: Um nome descritivo para teu projeto (um nome aleatório é gerado automaticamente)
- URL: O identificador do projeto, gerado a partir do nome e editável antes da criação
- Descrição: Notas opcionais sobre o propósito do projeto
- Visibilidade: Público (qualquer um pode visualizar) ou Privado (apenas tu e os membros da tua equipe podem acessar). Novos projetos são definidos como Públicos por padrão; workspaces Enterprise definem novos projetos como Privados com a licença Ultralytics-Enterprise.
- Licença: Licença opcional para o teu projeto (AGPL-3.0, Apache-2.0, MIT, GPL-3.0, BSD-3-Clause, LGPL-3.0, MPL-2.0, EUPL-1.1, Unlicense, Ultralytics-Enterprise e mais). A licença Ultralytics-Enterprise destina-se ao uso comercial sem requisitos AGPL e está disponível com um plano Enterprise — consulta Ultralytics Licensing.
Clica em Create Project para concluir. O teu novo projeto aparece na lista de projetos e na barra lateral.
Página do Projeto#
A página do projeto possui duas áreas principais:
| Área | Descrição |
|---|---|
| Barra Lateral de Modelos | Lista redimensionável de todos os modelos no projeto com pesquisa, filtros de status, opções de classificação e caixas de seleção para seleção |
| Painel Principal | Painel de gráficos ou tabela de comparação (alterna entre as visualizações) |

Cabeçalho do Projeto#
O cabeçalho exibe:
- Ícone do projeto (cor, letra ou imagem carregada personalizáveis)
- Nome editável (clica para renomear; o slug é atualizado automaticamente)
- Badge de licença
- Contagem de modelos, contagens de concluídos/em execução/com falha, tamanho total
- Contagem de clones e timestamp da última atualização
- Descrição (clica para editar)
Botões de ação no cabeçalho:
| Botão | Descrição |
|---|---|
| Novo Modelo | Abre a diálogo de treinamento para projetos editáveis |
| Carregar modelos | Seleciona um ou mais pontos de controle .pt para um projeto editável |
| Clonar projeto | Clona um projeto público e os respetivos modelos concluídos para o teu espaço de trabalho |
| Favoritar | Adiciona ou remove a estrela do projeto |
| Compartilhar | Partilha ou incorpora um projeto público |
| Atualizar | Atualiza os dados do projeto |
| Eliminar projeto | Move um projeto teu e os respetivos modelos para o lixo |
Modos de Visualização#
Alterna entre três modos de visualização usando os controles de visualização:
- Cards: Barra lateral de modelos de largura total com o painel de Gráficos à direita — curvas de perda e comparações de métricas para os modelos selecionados.
- Compacto: Barra lateral de modelos condensada com o painel de Gráficos à direita — mais espaço vertical para modelos em projetos com muitos experimentos.
- Tabela: Tabela de comparação mostrando argumentos de treinamento e métricas finais lado a lado. Ativa Diff para destacar apenas as colunas onde os valores diferem entre os modelos.

Barra Lateral de Modelos#
A barra lateral redimensionável lista todos os modelos no projeto:
- Caixas de seleção para selecionar quais modelos aparecem nos gráficos/tabela
- Pesquisa para filtrar modelos por nome
- Opções de visualização para filtro de status (Todos, Concluído, Não Treinado, Em Execução, Iniciando, Com Falha), agrupamento por tarefa e ordem de classificação
- Arrasta e solta arquivos
.ptdiretamente na barra lateral para carregar modelos (detalhes de carregamento de modelos) - Progresso do treinamento exibido para modelos em execução (contagem de épocas e barra de progresso)
Clica em qualquer modelo para abrir a respetiva página do modelo.
Ícone do Projeto#
Personaliza o ícone do teu projeto:
- Clica no ícone ao lado do nome do projeto
- Escolhe uma cor e letra, ou carrega uma imagem personalizada
- As alterações salvam automaticamente
Configurações de visibilidade#
Controla quem pode ver teu projeto:
| Configuração | Descrição |
|---|---|
| Público | Qualquer pessoa pode ver na página Explore |
| Privado | Apenas tu e os membros da tua equipe |
Compartilhar um Projeto#
Não existe convite de colaborador por projeto. Para compartilhar um projeto com outros, usa um destes mecanismos:
- A visibilidade Public permite que qualquer pessoa veja um projeto em Explore.
- As Teams criam um espaço de trabalho partilhado onde todos os recursos (projetos, conjuntos de dados, modelos, implantações) ficam acessíveis aos membros da equipa com permissões baseadas em funções. Usa as Teams para colaboração contínua.
Clonar Projeto#
Clona um projeto público para a tua própria conta:
- Visita a página do projeto público
- Clica em Clonar Projeto
- O projeto e seus modelos concluídos são copiados para o teu workspace; tu escolhes a visibilidade do clone no diálogo de clonagem
Projetos clonados herdam a visibilidade do projeto de origem por padrão (então, clonar um projeto público cria um clone público), e tu podes escolher Público ou Privado no diálogo de clonagem antes de confirmar. Workspaces Enterprise definem novos clones como privados por padrão. A contagem de clones é exibida no projeto original. Se o original possuir uma licença copyleft (por exemplo, AGPL-3.0), o clone herda e bloqueia essa licença.
Comparar Modelos#
Painel de Gráficos#
Compara o desempenho do modelo usando o painel de gráficos:
- Seleciona modelos na barra lateral usando caixas de seleção
- Visualiza curvas de métricas sobrepostas agrupadas por tipo (métricas, perda de treino, perda de validação, taxa de aprendizado)
- Arrasta os gráficos para reorganizar, redimensiona arrastando as bordas
- Passa o mouse para ver valores exatos, clica em itens da legenda para ocultar/mostrar modelos, clica em uma linha de modelo para navegar até esse modelo
Grupos de gráficos disponíveis:
| Grupo | Gráficos |
|---|---|
| Métricas | mAP50, mAP50-95, precisão, recall |
| Perda | train/box_loss, train/cls_loss, train/dfl_loss, val/box_loss, val/cls_loss, val/dfl_loss |
| Taxa de Aprendizado | lr/pg0, lr/pg1, lr/pg2 |
- Passa o mouse para ver valores exatos
- Clica em itens da legenda para ocultar/mostrar modelos
- Arrasta para ampliar regiões específicas
- Clica em uma linha de modelo para navegar até a página desse modelo
- Reorganiza e redimensiona gráficos; o layout persiste entre sessões
Tabela de Comparação#
Alterne para a visualização em tabela para uma comparação lado a lado dos argumentos de treinamento e métricas finais:
- Clique no botão de alternância do modo de visualização Table
- Veja todos os modelos selecionados como linhas, com os argumentos de treinamento e métricas como colunas
- Use o botão Diff para destacar apenas as colunas onde os valores diferem entre os modelos
Upload de Modelos#
Carrega arquivos de modelo .pt existentes:
- Arraste e solte os arquivos na página do projeto ou na barra lateral de modelos
- Vários arquivos podem ser enviados simultaneamente (até 3 uploads simultâneos)
- Os metadados do modelo (tarefa, arquitetura, nomes de classes, resultados de treinamento) são analisados automaticamente a partir do arquivo
.pt - Os gráficos são atualizados instantaneamente com os dados analisados localmente enquanto o upload é concluído em segundo plano
Apenas arquivos PyTorch .pt do treinamento Ultralytics YOLO são suportados. A Platform analisa os metadados embutidos, incluindo resultados de treinamento, argumentos, tipo de tarefa e nomes de classes. Consulta Models para obter detalhes de formato.
Editar Projeto#
Atualize o nome, a descrição ou as configurações do projeto:
- Clique no nome do projeto para editá-lo diretamente
- Clique na descrição para editá-la diretamente
- Clique no ícone para personalizá-lo
- Clique no selo de licença para alterar a licença

Metadados Personalizados#
Abre Mais ações e seleciona Informação para rever duas secções:
- Ultralytics Metadata: Detalhes da Platform somente leitura, tais como o ID do projeto, proprietário, visibilidade, licença, etiquetas e carimbos de data/hora
- Custom Metadata: O teu próprio objeto JSON para departamento, programa, centro de custos, governança ou outro contexto organizacional
Os visualizadores do Workspace podem inspecionar metadados, enquanto os membros com acesso de edição podem substituir o objeto de metadados personalizados. O objeto de metadados serializado está limitado a 500.000 caracteres e cada chave de nível superior está limitada a 128 caracteres. Guarda um objeto vazio ({}) para limpar os metadados personalizados.
Eliminar Projeto#
Remova um projeto que você não precisa mais:
- Clique no botão Delete (ícone de lixeira) no cabeçalho
- Confirme a exclusão
Excluir um projeto também exclui todos os modelos contidos nele. Esta ação move os itens para a Trash, onde podem ser restaurados dentro de 30 dias.
FAQ#
Quantos modelos um projeto pode conter?#
Não existe um limite de modelos separado por projeto. O limite do plano para todo o espaço de trabalho aplica-se a todos os projetos: Free suporta 100 modelos, Pro suporta 500 e Enterprise é ilimitado. Para comparações mais claras:
- Agrupar experimentos relacionados (mesmo dataset/tarefa)
- Move as execuções obsoletas para o lixo quando já não precisares delas
- Usar nomes de projetos significativos
Posso restaurar um projeto excluído?#
Sim, projetos excluídos vão para a Trash e podem ser restaurados dentro de 30 dias:
- Vai para Settings > Trash
- Encontre o projeto
- Clique em Restore
Posso transferir modelos entre projetos?#
Sim, podes clonar um modelo para um projeto diferente usando a caixa de diálogo de clonagem de modelo na página do modelo.