Skip to main content

Crear un repositorio nuevo

Puedes crear un repositorio nuevo en tu cuenta personal o la cuenta de cualquier organización en la que tengas los permisos suficientes.

Sugerencia: Los propietarios pueden restringir los permisos de creación del repositorio de una organización. Para obtener más información, vea «Restringir la creación de repositorios en tu organización».

Sugerencia: También puede crear un repositorio con una plantilla de la GitHub CLI. Para obtener más información, consulte "gh repo create" en la documentación de GitHub CLI.

Creación de un repositorio a partir de la interfaz de usuario web

  1. En la esquina superior derecha de cualquier página, selecciona y luego haz clic en Nuevo repositorio.

    Captura de pantalla del menú desplegable GitHub que muestra las opciones para crear nuevos elementos. El elemento de menú "New repository" está resaltado en naranja oscuro.

  2. Otra opción para crear un repositorio con la estructura de directorios y los archivos de un repositorio existente es seleccionar el menú desplegable Escoger una plantilla y hacer clic un repositorio de plantilla. Verás repositorios de plantillas que te pertenecen a ti y a las organizaciones de las que eres miembro o bien repositorios de plantillas que has usado anteriormente. Para obtener más información, vea «Crear un repositorio desde una plantilla».

  3. Si decidió elegir una plantilla, también puede incluir la estructura de directorios y los archivos de todas las ramas en la plantilla, y no únicamente aquellos de la rama predeterminada, seleccione Include all branches.

  4. Usa el menú desplegable Propietario para seleccionar la cuenta que quieres que sea propietaria del repositorio. Captura de pantalla del menú del propietario de un repositorio de GitHub nuevo. El menú muestra dos opciones, octocat y github.

  5. Teclea el nombre de tu repositorio, y una descripción opcional.

    Captura de pantalla del primer paso para crear un repositorio de GitHub. El campo "Repository name" contiene el texto "hello-world" y aparece en naranja oscuro.

  6. Elige la visibilidad del repositorio. Para obtener más información, vea «Acerca de los repositorios».

  7. Si no estás utilizando una plantilla, hay varios elementos opcionales que puedes pre-cargar en tu repositorio. Si estás importando un repositorio existente a GitHub, no elijas ninguna de estas opciones, ya que producirás un conflicto de fusión. Puedes agregar o crear nuevos archivos usando la interfaz de usuario o elegir agregar nuevos archivos usando luego la línea de comando. Para más información, consulte "Importación de un repositorio de Git externo mediante la línea de comandos," "Agregar un archivo a un repositorio" y "Cómo abordar los conflictos de combinación".

    • Puedes crear un README, que es un documento que describe tu proyecto. Para obtener más información, vea «Acerca de los archivos README».
    • Puede crear un archivo .gitignore, que es un conjunto de reglas de omisión. Para más información, consulta "Ignorar archivos".
    • Puedes elegir agregar una licencia de software a tu proyecto. Para más información, consulta "Generar licencia para un repositorio".
  8. Opcionalmente, si la cuenta personal o la organización en la que va a crear usa cualquier GitHub Apps de GitHub Marketplace, seleccione las aplicaciones que le gustaría usar en el repositorio.

  9. Haga clic en Create repository (Crear repositorio).

  10. En la parte inferior de la página de Configuración rápida resultante, en "Importar el código del repositorio anterior", puedes elegir importar un proyecto en tu nuevo repositorio. Para ello, haga clic en Import code.

Creación de un repositorio a partir de una consulta de dirección URL

Puedes usar parámetros de consulta para rellenar previamente los campos de formulario al crear un nuevo repositorio. Los parámetros de consulta son partes opcionales de una URL que puedes personalizar para compartir una vista de página web específica, como los resultados de filtro de búsqueda o una plantilla de propuestas en GitHub. Para especificar valores para los parámetros de consulta predefinidos, deben coincidir con el par clave y valor.

Es posible que los campos de formulario rellenados previamente con una consulta de dirección URL sean útiles si a menudo quieres crear repositorios con la misma configuración predeterminada. Por ejemplo, un profesor puede querer que cada alumno de una clase cree un repositorio en su cuenta personal con el mismo nombre, descripción y visibilidad. Con una consulta de dirección URL, el profesor puede crear un vínculo que rellene previamente el nombre del repositorio, los campos de descripción y visibilidad, y compartirlo con toda la clase.

Debes tener los permisos adecuados para cualquier acción para usar el parámetro de consulta equivalente. Por ejemplo, debes tener permiso para crear un repositorio en una organización para especificar la organización como propietario del repositorio en un parámetro de consulta. Para obtener más información, vea «Roles de repositorio para una organización».

Si creas una dirección URL no válida mediante parámetros de consulta o si no tienes los permisos adecuados, se omitirán los parámetros de consulta no válidos y el resto de la dirección URL funcionará de la manera habitual. Si crea una dirección URL que supere el límite del servidor, la dirección URL devolverá una página de error 414 URI Too Long.

Parámetro de consultaEjemploValores válidos
namehttps://github.com/new?name=test-repo&owner=avocado-corp crea un repositorio denominado "test-repo" propiedad de la organización "avocado-corp".Nombre del repositorio. Los espacios deben reemplazarse por + o %20.
descriptionhttps://github.com/new?description=An+exciting+repository&visibility=private&owner=octocat crea un repositorio con la descripción "Un repositorio emocionante" con visibilidad privada propiedad de @octocat.Cualquier cadena Los espacios deben reemplazarse por + o %20.
visibilityhttps://github.com/new?visibility=private crea un repositorio con visibilidad privada.public
private
ownerhttps://github.com/new?owner=avocado-corp&visibility=public crea un repositorio público propiedad de la organización "avocado-corp".Cualquier nombre de organización o nombre de usuario válido. Como alternativa, mientras has iniciado sesión, utiliza @me para especificar la cuenta de usuario como propietario.
template_owner y template_namehttps://github.com/new?owner=avocado-corp&template_owner=avocado-corp&template_name=octo-repo crea un repositorio que pertenece a "avocado-corp" mediante la plantilla de avocado-corp "octo-repo".Nombre de usuario del propietario de la plantilla y el nombre de la plantilla del repositorio.

Información adicional