Preparación del entorno · 00-06

Principiante absoluto⏱ 90 minPaso a paso

Instalar Git y publicar tu primer repositorio

Instalar Git, configurarlo, crear commits y publicar un repositorio sin secretos.

Siguiente acción: Verifica git --version. No crees el repositorio hasta que Git responda.
!

Cómo utilizar esta lección

Haz un paso a la vez. Después de cada paso compara tu pantalla con el resultado esperado.

No marques el checklist por leer: márcalo únicamente después de probar.

🎯 Al terminar podrás

Instalar Git, configurarlo, crear commits y publicar un repositorio sin secretos.

Palabras nuevas

  • git config
  • git init
  • status
  • add
  • commit
  • remote
  • push

🧭 Instrucciones paso a paso

1

Comprueba Git

En Terminal o PowerShell ejecuta git --version.

Resultado esperado: Aparece git version seguido de un número.
Antes de continuar: Si no responde, instala Git antes de continuar.
2

Instala Git en macOS

Si macOS lo solicita, instala Xcode Command Line Tools. También puedes usar Homebrew si ya lo utilizas. Elige una sola ruta.

Resultado esperado: git --version funciona después de reiniciar Terminal.
Antes de continuar: No instales dos versiones sin saber cuál usa which git.
3

Instala Git en Windows

Descarga Git for Windows o usa WinGet. Completa la instalación y reinicia PowerShell.

Resultado esperado: git --version y where.exe git responden.
Antes de continuar: Acepta las opciones por defecto del instalador si no comprendes una alternativa avanzada.
4

Configura tu identidad

Ejecuta git config --global user.name y user.email con tus datos. Verifica ambos valores.

Resultado esperado: Los comandos de lectura muestran tu nombre y correo verificado.
Antes de continuar: No copies el correo del ejemplo literalmente.
5

Prepara .gitignore

Dentro del proyecto crea .gitignore con .venv/, .env y __pycache__/.

Resultado esperado: git status no muestra esos archivos cuando existen.
Antes de continuar: Crea .gitignore antes del primer git add .
6

Inicializa el repositorio

En la carpeta del curso ejecuta git init y git status.

Resultado esperado: Git informa que estás en un repositorio y muestra archivos sin seguimiento.
Antes de continuar: Ejecuta pwd/Get-Location antes de git init para no inicializar la carpeta equivocada.
7

Crea el primer commit

Ejecuta git add README.md, revisa git status y ejecuta git commit -m con un mensaje claro.

Resultado esperado: git log --oneline muestra el commit.
Antes de continuar: No uses git add . hasta revisar qué archivos incluirás.
8

Crea el remote en GitHub

En GitHub crea un repositorio vacío. Copia su URL, añade origin, cambia la rama a main y realiza push.

Resultado esperado: La página de GitHub muestra README y archivos del proyecto.
Antes de continuar: No inicialices con README remoto si ya tienes uno local, para evitar conflictos en esta primera práctica.

⌨️ Comandos y archivos

Escribe los comandos uno por uno. Presiona Enter después de cada línea.

Configuración
git --version
git config --global user.name "TU NOMBRE"
git config --global user.email "TU CORREO"
git config --global --list
Primer commit
git init
git status
git add README.md
git commit -m "docs: add first README"
git log --oneline
Publicar
git branch -M main
git remote add origin URL_DEL_REPOSITORIO
git remote -v
git push -u origin main
Comprobación final: El repositorio aparece en GitHub, .env y .venv no están publicados, y git status queda limpio.

🛠️ Solución de problemas

Lo que vesQué hacer
not a git repositoryEntra a la carpeta correcta y ejecuta git init.
nothing to commitNo hay cambios nuevos o no guardaste el archivo. Revisa git status.
remote origin already existsEjecuta git remote -v. Corrige con git remote set-url origin URL en vez de agregar otro.
authentication failedInicia sesión mediante VS Code, GitHub Desktop, Git Credential Manager o GitHub CLI. No uses la contraseña normal como token.
.env fue agregadoDetente antes de push. Quita el archivo del índice, añádelo a .gitignore y verifica nuevamente.

🤖 Usa Cursor como tutor

Estoy siguiendo la lección 00-06 para una persona principiante.
Explica el siguiente paso sin ejecutar comandos por mí.
Indica qué debería ver y cómo comprobarlo.
No modifiques archivos ni configuración sin mi aprobación.

🏁 Desafíos

El desafío esencial es parte de la lección. Los otros dos permiten practicar más.

🟢 Esencial

Publica README.md y hello.py en un repositorio privado o público seguro.

🟡 Práctica

Crea una rama docs/readme, mejora el README y fusiona la rama.

🔴 Desafío

Abre un pull request desde una rama feature y documenta el diff con captura.

✅ Checklist mejorado

Tu progreso se guarda en este navegador. Una lección se completa cuando todas las comprobaciones están marcadas.

Instalación

Marca cada punto solamente después de comprobarlo.

Seguridad

Marca cada punto solamente después de comprobarlo.

Publicación

Marca cada punto solamente después de comprobarlo.

Comprensión

Marca cada punto solamente después de comprobarlo.

🧠 Comprueba que lo entendiste

  1. ¿Qué herramienta instalaste o configuraste?
  2. ¿Qué comando o pantalla confirma que funciona?
  3. ¿Qué error podrías reconocer ahora?
  4. ¿Qué no deberías publicar o ejecutar sin revisar?