Projetos#
Os projetos da Ultralytics Platform oferecem uma solução eficaz para organizar e gerir os teus modelos. Agrupa modelos relacionados para facilitar a gestão, a 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 --> S[Check in Sidebar]:::proc
M2 --> S
M3 --> S
S --> C[Charts]:::out
S --> T[Comparison Table]:::out
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 da página inicial.
Introduz os detalhes do teu projeto:
- Nome: Um nome descritivo para o teu projeto (é gerado automaticamente um nome aleatório)
- URL: O slug do projeto, gerado a partir do nome e editável antes da criação
- Descrição: Notas opcionais sobre a finalidade do projeto
- Visibilidade: Público (qualquer pessoa pode ver) ou Privado (apenas tu e os membros da tua equipa podem aceder). Os novos projetos são definidos como Públicos por predefinição; os espaços de trabalho Enterprise definem os novos projetos como Privados por predefinição, com a licença Ultralytics-Enterprise.
- Licença: Licença opcional para o teu projeto (Nenhuma, Apache-2.0, MIT, BSD-3-Clause, AGPL-3.0, GPL-3.0, LGPL-3.0, MPL-2.0, EUPL-1.1, Unlicense, CC0-1.0, Ultralytics-Enterprise ou Outra). A licença Ultralytics-Enterprise destina-se a utilização comercial sem requisitos AGPL e está disponível com um plano Enterprise — consulta Licenciamento da Ultralytics. Os espaços de trabalho Enterprise pré-selecionam esta licença para novos projetos.

Clica em Create Project para finalizar. O teu novo projeto aparece na lista de projetos e na barra lateral.
Página do projeto#
A página do projeto tem duas áreas principais:
| Área | Descrição |
|---|---|
| Barra lateral de modelos | Lista redimensionável de todos os modelos do projeto, com caixas de seleção para selecionar os gráficos |
| Painel principal | Dashboard de gráficos ou tabela de comparação (alterna entre vistas) |
Uma linha de controlos acima de ambas as áreas contém a caixa de pesquisa de modelos, o seletor Diff (apenas na vista de tabela, com um indicador do número de colunas diferentes), o menu pendente de opções da vista e o seletor do modo de vista.

Cabeçalho do projeto#
O cabeçalho apresenta:
- Ícone do projeto (cor, letra ou imagem carregada personalizável)
- Nome editável (clica para mudar o nome; o slug é atualizado automaticamente)
- Seletor de licença (clica para alterar; as licenças copyleft herdadas de um clone estão bloqueadas)
- Número de modelos, números de modelos concluídos/em formação/com falha, tamanho total
- Número de clones e indicação de última atualização
- Descrição (clica para editar)
Botões de ação no cabeçalho:
| Botão | Descrição |
|---|---|
| Novo modelo | Abre o diálogo de formação para projetos editáveis |
| Carregar modelos | Seleciona um ou mais checkpoints .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 |
| Estrela | Adiciona ou remove o projeto dos favoritos |
| Partilhar | Partilha ou incorpora um projeto público |
| Mais ações | Informações (metadados), Atualizar e Eliminar projeto para proprietários |
O indicador de visibilidade do projeto encontra-se junto ao nome, na localização estrutural no topo da página; clica nele para alternar entre público e privado.
Modos de vista#
Alterna entre três modos de vista utilizando os controlos de vista. O modo selecionado é guardado por projeto.
- Cartões: Cartões de modelos em tamanho completo na barra lateral, com o dashboard 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 dashboard de Gráficos à direita — mais espaço vertical para modelos em projetos com muitas experiências.
- Tabela: Tabela de comparação que apresenta os argumentos de formação e as métricas finais lado a lado. Ativa Diff para mostrar apenas as colunas em que os valores diferem entre os modelos.

Filtrar e ordenar#
A linha de controlos acima da lista de modelos disponibiliza:
- Pesquisa para filtrar modelos pelo nome
- Filtro de estado: Todos, Concluído, Sem formação, Em execução, A iniciar ou Com falha
- Agrupar por: Nenhum ou Tarefa — o agrupamento aplica-se aos modos Compacto e Tabela
- Ordenar por: Criado, Nome ou Tamanho, cada um por ordem ascendente ou descendente
Barra lateral de modelos#
A barra lateral redimensionável apresenta todos os modelos do projeto:
- Caixas de seleção para escolher quais modelos aparecem nos gráficos e na tabela de comparação
- Arrastar e largar ficheiros
.ptdiretamente na barra lateral para carregar modelos (detalhes do carregamento de modelos) - Progresso da formação apresentado para modelos em execução (número de épocas e barra de progresso)
- Seletor de cor do modelo, utilizado de forma consistente em todos os gráficos
Clica em qualquer modelo para abrir a sua página do modelo.
Ícone do projeto#
Personaliza o ícone do teu projeto:
- Clica no ícone junto ao nome do projeto
- Escolhe uma cor e uma letra, ou carrega uma imagem personalizada
- As alterações são guardadas automaticamente
Definições de visibilidade#
Controla quem pode ver o teu projeto:
| Definição | Descrição |
|---|---|
| Público | Qualquer pessoa pode ver na página Explorar |
| Privado | Apenas tu e os membros da tua equipa |
Partilhar um projeto#
Não existe um convite de colaborador por projeto. Para partilhares um projeto com outras pessoas, utiliza um destes mecanismos:
- A visibilidade Pública permite que qualquer pessoa veja um projeto em Explorar.
- As Equipas criam um espaço de trabalho partilhado onde todos os recursos (projetos, conjuntos de dados, modelos e implementações) estão acessíveis aos membros da equipa com permissões baseadas em funções. Utiliza as Equipas 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 os respetivos modelos concluídos são copiados para o teu espaço de trabalho; escolhes a visibilidade do clone no diálogo de clonagem
Por predefinição, os projetos clonados herdam a visibilidade do projeto de origem (por isso, clonar um projeto público cria um clone público), e podes escolher Público ou Privado no diálogo de clonagem antes de confirmares. Os espaços de trabalho Enterprise definem os novos clones como privados por predefinição. O número de clones é apresentado no projeto original. Se o original tiver uma licença copyleft (por exemplo, AGPL-3.0), o clone herda e bloqueia essa licença.
Comparar modelos#
Dashboard de gráficos#
Compara o desempenho dos modelos utilizando o dashboard de gráficos:
- Seleciona modelos na barra lateral utilizando as caixas de seleção
- Consulta curvas de métricas sobrepostas, agrupadas por tipo (métricas, perda, taxa de aprendizagem)
- Arrasta os gráficos para os reorganizar e redimensiona-os arrastando as margens
- Passa o cursor para veres os valores exatos, clica nos itens da legenda para ocultar/mostrar modelos e clica numa linha de modelo para navegar até esse modelo
Grupos de gráficos disponíveis:
| Grupo | Gráficos |
|---|---|
| Métricas | Métricas da tarefa, como mAP50, mAP50-95, precisão e recall para deteção |
| Perda | Um gráfico por componente de perda (box, cls, …), formação a cheio e validação tracejada |
| Taxa de aprendizagem | lr/pg0, lr/pg1, lr/pg2 |
É possível comparar modelos treinados para tarefas diferentes, mas cada modelo só aparece nos gráficos das métricas que efetivamente reportou.
- Passe o cursor para ver os valores exatos
- Clique nos itens da legenda para ocultar/mostrar modelos
- Arraste para ampliar regiões específicas
- Clique numa linha de modelo para navegar para a página desse modelo
- Recolha um grupo ou use o respetivo menu para ocultar gráficos individuais e as séries de perda de treino ou validação
- Reorganize e redimensione os gráficos; o esquema mantém-se entre sessões
Tabela de comparação#
Mude para a vista de tabela para comparar lado a lado os argumentos de treino e as métricas finais:
- Clique no seletor do modo de vista Tabela
- Veja todos os modelos selecionados como linhas, com os argumentos de treino e as métricas como colunas
- Use o botão Diferenças para mostrar apenas as colunas cujos valores diferem entre os modelos
Carregar modelos#
Carregue ficheiros de modelos .pt existentes:
- Faça arrastar e largar dos ficheiros na página do projeto ou na barra lateral de modelos
- É possível carregar vários ficheiros simultaneamente (até 3 carregamentos em simultâneo)
- Os metadados do modelo (tarefa, arquitetura, nomes das classes e resultados do treino) são analisados automaticamente a partir do ficheiro
.pt - Os gráficos são atualizados instantaneamente a partir dos dados analisados localmente enquanto o carregamento é concluído em segundo plano
Só são suportados ficheiros PyTorch .pt provenientes do treino do Ultralytics YOLO. A Platform analisa os metadados incorporados, incluindo resultados do treino, argumentos, tipo de tarefa e nomes das classes. Consulte Modelos para obter detalhes sobre o formato.
Editar projeto#
Atualize o nome, a descrição ou as definições do projeto:
- Clique no nome do projeto para o editar diretamente
- Clique na descrição para a editar diretamente
- Clique no ícone para o personalizar
- Clique no emblema da licença para alterar a licença

Metadados personalizados#
Abre Mais ações e seleciona Informações para rever duas secções:
- Metadados da Ultralytics: detalhes da Platform apenas para leitura, como o ID do projeto, o proprietário, a visibilidade, a licença, as etiquetas e as marcas temporais
- Metadados personalizados: o seu próprio objeto JSON para o departamento, programa, centro de custos, governação ou outro contexto organizacional
Os visualizadores do workspace podem inspecionar os 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. Guarde um objeto vazio ({}) para limpar os metadados personalizados.
Eliminar projeto#
Remova um projeto de que já não precisa:
- Abra o menu Mais ações no cabeçalho e selecione Eliminar projeto
- Confirma a eliminação
Eliminar um projeto também elimina todos os modelos nele contidos. Esta ação move os itens para o Lixo, onde podem ser restaurados no prazo de 30 dias.
Perguntas frequentes#
Não existe um limite separado de modelos por projeto. O limite do plano aplicável a todo o espaço de trabalho aplica-se a todos os projetos: o plano Free suporta 100 modelos, o Pro suporta 500 e o Enterprise é ilimitado. Para comparações mais claras:
- Agrupe experiências relacionadas (mesmo conjunto de dados/tarefa)
- Elimine execuções obsoletas para o Lixo quando já não precisar delas
- Utilize nomes de projetos significativos
Sim, os projetos eliminados vão para o Lixo e podem ser restaurados no prazo de 30 dias:
- Aceda a Definições > Lixo
- Encontre o projeto
- Clique em Restaurar
Sim. Podes recortar e colar ou arrastar modelos entre projetos no mesmo espaço de trabalho; vê Mover Modelos Entre Projetos. Clonar Modelo copia para o teu projeto um modelo concluído que não te pertence.