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 --> 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 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.
- License: Licença opcional para o teu projeto (None, 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 Other). A licença Ultralytics-Enterprise destina-se a uso comercial sem os requisitos da AGPL e está disponível com um plano Enterprise — vê Ultralytics Licensing. Os espaços de trabalho Enterprise pré-selecionam-na para novos projetos.
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 caixas de seleção para a seleção de gráficos |
| Painel Principal | Painel de gráficos ou tabela de comparação (alterna entre as visualizações) |
Uma linha de controlos acima de ambas as áreas contém a caixa de pesquisa de modelos, o comutador Diff (apenas na vista de tabela, com um indicador do número de colunas que diferem), o menu dropdown de opções de vista e o comutador de modo de vista.

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)
- Seletor de licença (clica para alterar; as licenças copyleft herdadas de um clone estão bloqueadas)
- Contagem de modelos, contagens de concluídos/em treino/falhados, 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 |
| More actions | Information (metadados), Refresh e Delete Project para os proprietários |
O emblema de visibilidade do projeto fica ao lado do seu nome no caminho de navegação (breadcrumb) no topo da página; clica nele para alternar entre público e privado.
Modos de Visualização#
Alterna entre três modos de vista usando os controlos de visualização. O modo selecionado é memorizado por projeto.
- Cards: Cartões de modelo de tamanho completo na barra lateral com o painel Charts à 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.
- Table: Tabela de comparação que mostra os argumentos de treino e as métricas finais lado a lado. Ativa Diff para mostrar apenas as colunas onde os valores diferem entre os modelos.

Filter and Sort#
A linha de controlos acima da lista de modelos fornece:
- Pesquisa para filtrar modelos por nome
- Status filter: All, Completed, Untrained, Running, Starting ou Failed
- Group by: None ou Task — o agrupamento aplica-se nos modos Compact e Table
- Sort by: Created, Name ou Size, cada um de forma ascendente ou descendente
Barra Lateral de Modelos#
A barra lateral redimensionável lista todos os modelos no projeto:
- Caixas de seleção para escolher quais modelos aparecem nos gráficos e na tabela de comparaçã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)
- Seletor de Model color, usado de forma consistente em todos os gráficos
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
- vê curvas de métricas sobrepostas agrupadas por tipo (métricas, perda, taxa de aprendizagem)
- 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 | Métricas da tarefa, tais como mAP50, mAP50-95, precisão e recuperação (recall) para deteção |
| Perda | Um gráfico por componente de perda (box, cls, ...), com o treinamento em linha contínua e a validação em linha tracejada |
| Taxa de Aprendizado | lr/pg0, lr/pg1, lr/pg2 |
Comparar modelos treinados para tarefas diferentes funciona, mas cada modelo apenas desenha nos gráficos as métricas que efetivamente reportou.
- 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
- Recolhe um grupo ou usa o respetivo menu para ocultar gráficos individuais e as séries de perda de treino ou validação
- 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
- Usa o botão Diff para mostrar 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:
- Abre o menu More actions no cabeçalho e seleciona Delete Project
- 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#
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
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
Sim, podes clonar um modelo para um projeto diferente usando a caixa de diálogo de clonagem de modelo na página do modelo.