Skip to main content

Criar um repositório

Você pode criar um repositório na sua conta pessoal ou em qualquer organização onde tenha permissões suficientes.

Dica: os proprietários podem restringir as permissões de criação de repositórios em uma organização. Para obter mais informações, confira "Restringir a criação de repositórios na organização".

Dica: crie também um repositório usando a GitHub CLI. Para obter mais informações, confira "gh repo create" na documentação da GitHub CLI.

Criar um repositório a partir da interface do usuário da web

  1. No canto superior direito de qualquer página, selecione e clique em Novo repositório.

    Captura de tela de um menu suspenso GitHub mostrando as opções para criar novos itens. Há um item de menu "Novo repositório" com o contorno em laranja escuro.

  2. Opcionalmente, para criar um repositório com a estrutura de diretório e os arquivos de um repositório existente, selecione o menu suspenso Escolher um modelo e clique em um repositório de modelo. Você verá repositórios de modelo que pertencem a você e às organizações das quais você é integrante ou que usou antes. Para obter mais informações, confira "Criar um repositório a partir de um modelo".

  3. Opcionalmente, se você escolheu usar um modelo para incluir a estrutura do diretório e os arquivos de todos os branches no modelo, não apenas o branch padrão, selecione Incluir todos os branches.

  4. Use o menu suspenso Proprietário para selecionar a conta que deseja atribuir como proprietário do repositório. Captura de tela do menu Proprietário de um novo repositório do GitHub. O menu mostra duas opções, octocat e github.

  5. Digite um nome para o seu repositório e uma descrição opcional.

    Captura de tela da primeira etapa na criação de um repositório do GitHub. O campo "Nome do repositório" contém o texto "hello-world" e está contornado em laranja escuro.

  6. Escolha uma visibilidade do repositório. Para obter mais informações, confira "Sobre repositórios".

  7. Se você não estiver usando um modelo, haverá um número de itens opcionais com os quais você pode preencher previamente o seu repositório. Se for importar um repositório existente para o GitHub, não escolha qualquer uma destas opções, pois isso poderá criar um conflito de merge. É possível adicionar ou criar arquivos usando a interface de usuário ou optar por adicionar novos arquivos posteriormente usando a linha de comando. Para saber mais, confira "Como importar um repositório Git externo usando a linha de comando", "Adicionar um arquivo a um repositório" e "Resolvendo conflitos de mesclagem".

    • Você pode criar um README, que é um documento que descreve seu projeto. Para obter mais informações, confira "Sobre LEIAMEs".
    • Você pode criar um arquivo .gitignore, que é um conjunto de regras a serem ignoradas. Para mais informações, confira "Ignorar arquivos".
    • Você pode optar por adicionar uma licença de software para seu projeto. Para obter mais informações, confira "Licenciar um repositório".
  8. Opcionalmente, se a conta pessoal ou de organização na qual você está criando usar GitHub Apps do GitHub Marketplace, selecione os aplicativos que deseja usar no repositório.

  9. Clique em Criar repositório.

  10. Na parte inferior da página Configuração rápida resultante, em "Import code from an old repository" (Importar código de um repositório antigo), você pode optar por importar um projeto para o novo repositório. Para fazer isso, clique em Importar código.

Criar um repositório a partir de uma consulta de URL

É possível usar parâmetros de consulta para preencher previamente os campos do formulário ao criar um repositório. Os parâmetros de consulta são partes opcionais de uma URL que podem ser personalizadas para compartilhar uma exibição de página web específica, como resultados do filtro de pesquisa ou um modelo de problemas no GitHub. Para especificar valores para os parâmetros de consulta predefinidos, é necessário corresponder ao par de chave e valor.

O preenchimento prévio de campos de formulário com uma consulta de URL pode ser útil se você deseja criar repositórios com as mesmas configurações padrão. Por exemplo, um professor pode querer que cada aluno de uma turma crie um repositório em sua conta pessoal com o mesmo nome, descrição e visibilidade. Usando uma consulta de URL, o professor pode criar um link que preencha previamente o nome do repositório, a descrição e os campos de visibilidade e compartilhá-lo com toda a turma.

Você deve ter as permissões adequadas para qualquer ação para usar o parâmetro de consulta equivalente. Por exemplo, é necessário ter permissão para criar um repositório em uma organização para especificar a organização como o proprietário do repositório em um parâmetro de consulta. Para obter mais informações, confira "Funções de repositório para uma organização".

Se você criar um URL inválido usando parâmetros de consulta ou se não tiver as permissões adequadas, os parâmetros de consulta inválidos serão ignorados e o restante do URL funcionará normalmente. Se você criar uma URL que exceda o limite do servidor, a URL retornará uma página de erro 414 URI Too Long.

Parâmetro de consultaExemploValores válidos
nameO https://github.com/new?name=test-repo&owner=avocado-corp cria um repositório chamado "test-repo" de propriedade da organização "avocado-corp".Qualquer nome de repositório válido. Os espaços devem ser substituídos por + ou %20.
descriptionO https://github.com/new?description=An+exciting+repository&visibility=private&owner=octocat cria um repositório com a descrição "Um repositório interessante" com visibilidade privada pertencente a @octocat.Qualquer cadeia de caracteres. Os espaços devem ser substituídos por + ou %20.
visibilityO https://github.com/new?visibility=private cria um repositório com visibilidade privada.public
private
ownerO https://github.com/new?owner=avocado-corp&visibility=public cria um repositório público de propriedade da organização "avocado-corp".Qualquer nome de organização ou nome de usuário válido. Como alternativa, enquanto estiver conectado, use @me para especificar sua conta de usuário como o proprietário.
template_owner e template_nameO https://github.com/new?owner=avocado-corp&template_owner=avocado-corp&template_name=octo-repo cria um repositório de propriedade de "avocado-corp" usando o modelo "octo-repo" da avocado-corp.O nome de usuário do proprietário do modelo e o nome do modelo de repositório.

Leitura adicional