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

Hacé 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.

Antes de comenzar

🎯 Qué vas a lograr en esta lección

¿Qué problema vas a resolver?

Aprenderás a configurar git, crear commits y conectar un repositorio con github. La idea es partir de una necesidad concreta, no de memorizar código.

¿Qué vas a construir?

Git Repository Auditor: un proyecto pequeño para preparar una herramienta de trabajo. El nombre técnico identifica la carpeta del proyecto; no necesitás memorizarlo.

¿Por qué es útil?

Te ayuda a evitar errores de instalación y saber comprobar que tu computadora está lista.

¿Qué vas a aprender?

Practicarás reconocer la función de cada herramienta y verificarla con una prueba pequeña. Cada término nuevo se explica antes de usarlo.

Tu primera acción

No instalés ni ejecutes nada todavía. Primero lee las palabras esenciales y observa el ejemplo pequeño. Después identificarás qué dato entra, qué instrucción trabaja y qué resultado aparece.

Cómo usar esta lección

Avanza una parte a la vez

1
Aprende

Leé las palabras nuevas y el ejemplo pequeño.

2
Practica

Seguí los pasos sin cambiar varias cosas a la vez.

3
Comprueba

Respondé las preguntas y usa pistas cuando lo necesites.

4
Cierra

Marcá el checklist y toma una pausa antes de continuar.

No necesitás terminar todo de una vez. Completa una parte y continúa cuando estés listo.
Parte 1

Aprende las palabras esenciales

Leé definiciones cortas y explica cada palabra con un ejemplo propio.

Base conceptual — léela antes de practicar

🧱 Conceptos esenciales explicados desde cero

Esta sección no es opcional. Presenta las palabras y procesos que necesitás para comprender el ejemplo. Leé una definición, observa el ejemplo y explícalo con una frase propia antes de avanzar.

programa

Qué significa: Conjunto ordenado de instrucciones que una computadora puede ejecutar.

Para qué sirve: Permite transformar una entrada en un resultado repetible.

Ejemplo: Un archivo que muestra “Hola” al ejecutarse.

Confusión frecuente: Un programa no es lo mismo que una página visual: puede funcionar solo en terminal.

python

Qué significa: Lenguaje de programación y también nombre del intérprete que ejecuta archivos .py.

Para qué sirve: Sirve para escribir automatizaciones, APIs, análisis de datos e IA.

Ejemplo: python3 saludo.py ejecuta el archivo saludo.py en macOS.

Confusión frecuente: VS Code no instala Python; solo ayuda a escribir y ejecutar código.

interprete

Qué significa: Programa que lee y ejecuta código Python.

Para qué sirve: Convierte instrucciones escritas en acciones que el sistema puede realizar.

Ejemplo: python3 o python apuntan a un intérprete instalado.

Confusión frecuente: La extensión de VS Code no reemplaza al intérprete.

entrada

Qué significa: Dato que una persona, archivo, API o sistema entrega al programa.

Para qué sirve: Es el punto de partida del proceso.

Ejemplo: El texto escrito con input() o un archivo CSV.

Confusión frecuente: La entrada debe validarse; no se debe asumir que siempre es correcta.

salida

Qué significa: Resultado que produce el programa.

Para qué sirve: Permite comprobar que el proceso funcionó.

Ejemplo: Texto en terminal, archivo generado o respuesta JSON.

Confusión frecuente: Una salida visible no garantiza que todos los casos estén correctos.

Ejemplo mínimo del entorno

Este ejemplo es deliberadamente pequeño. Su objetivo es mostrar las piezas básicas sin mezclar todavía toda la lógica del proyecto.

archivo.py → intérprete de Python → sistema operativo → resultado
VS Code edita; la terminal ejecuta; Git registra cambios.
  1. Identificá los nombres nuevos: subraya variables, funciones, tipos, herramientas o pasos.
  2. Señala la entrada: qué dato recibe o qué valor ya está escrito.
  3. Señala el proceso: qué instrucción transforma, valida, consulta o calcula.
  4. Señala la salida: qué resultado puede verse o verificarse.
  5. Explícalo: completa “el programa recibe ___, hace ___ y entrega ___”.
No continués todavía si no podés explicar al menos tres términos y el flujo entrada → proceso → salida sin copiar el texto.
Parte 2

Mirá un ejemplo pequeño

Comprende primero una comprobación sencilla y después sigue las instrucciones.

Ejemplo pequeño antes de continuar

Revisar antes de publicar

Leé una línea a la vez. No memoricés el comando: identificá qué comprueba.

git status
git add README.md
git commit -m "docs: add README"
Resultado explicado: Primero revisás, luego preparas y finalmente guardás una versión local.
  1. ¿Qué escribís o seleccionás?
  2. ¿Qué herramienta realiza el trabajo?
  3. ¿Qué resultado confirma que funcionó?

🧭 Instrucciones paso a paso

1

Comprobá 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

Instalá Git en macOS

Si macOS lo solicita, instala Xcode Command Line Tools. También podés usar Homebrew si ya lo utilizás. Elegí una sola ruta.

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

Instalá Git en Windows

Descargá Git for Windows o usa WinGet. Completá 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

Configurá tu identidad

Ejecutá git config --global user.name y user.email con tus datos. Verificá 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

Creá el primer commit

Ejecutá 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 usés git add . hasta revisar qué archivos incluirás.
8

Creá el remote en GitHub

En GitHub crea un repositorio vacío. Copiá 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 tenés uno local, para evitar conflictos en esta primera práctica.

⌨️ Comandos y archivos

Escribí los comandos uno por uno. Presioná 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. Revisá git status.
remote origin already existsEjecutá 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 usés 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.

Aprende las palabras antes de usarlas

🧠 Conceptos explicados desde cero

No necesitás memorizar estas palabras. Comprende qué hace cada una y dónde la verás.

remote

Qué significa: Dirección de un repositorio externo conectado al repositorio local.

Para qué sirve: Indicar dónde hacer push o pull.

Ejemplo pequeño: git remote -v

Confusión frecuente: origin es un nombre convencional, no una palabra obligatoria.

push

Qué significa: Enviar commits locales a un repositorio remoto.

Para qué sirve: Publicar cambios en GitHub.

Ejemplo pequeño: git push

Confusión frecuente: Solo envía commits; cambios sin commit no se publican.

pull

Qué significa: Descargar e integrar cambios del remoto.

Para qué sirve: Actualizar la copia local.

Ejemplo pequeño: git pull

Confusión frecuente: Puede producir conflictos si cambió la misma parte en dos lugares.

autenticación

Qué significa: Proceso para demostrar que una cuenta tiene permiso.

Para qué sirve: Permitir operaciones privadas o de escritura.

Ejemplo pequeño: Inicio de sesión mediante VS Code o GitHub CLI.

Confusión frecuente: No publiques tokens ni contraseñas.

Primero entiende el ejemplo

🖼️ Explicación ilustrada: entrada → proceso → resultado

Commit es guardar el documento; push es subirlo a una biblioteca en línea.

Situación

Ya tenés commits locales y querés mostrarlos en GitHub.

Entrada

Configuras origin y ejecutás git push.

Proceso

Git autentica tu cuenta y envía los commits pendientes.

Resultado

El repositorio de GitHub muestra los archivos y el historial.

Ejemplo antes y después

Antes

Antes del push: el proyecto solo existe en tu computadora.

Después

Después del push: existe una copia remota verificable.

¿Cómo usarás este ejemplo en el mini proyecto?

Ahora practicarás con un mini proyecto. Primero observarás el ejemplo, después cambiarás una sola parte y finalmente explicarás el resultado.

1. ObservarVer el ejemplo
2. EntenderRelacionar datos y resultado
3. CambiarModificar una sola cosa
4. EjecutarComprobar el resultado
5. ExplicarDecir qué aprendiste

Regla: cambia una sola parte, ejecuta de nuevo y explica qué diferencia observaste. No necesitás reconstruir el proyecto completo.

Parte 3

Practica con un mini proyecto

Hacé un cambio pequeño, ejecuta el código y observa qué cambió.

Practica paso a paso

🧩 Mini proyecto guiado: Instalar Git y publicar tu primer repositorio

Completá estos ejercicios pequeños antes del desafío. Podés equivocarte: el sistema te explicará qué repasar y te dará una pista.

Paso 1

Reconoce una palabra nueva

En esta lección aparece programa. ¿Cuál es la mejor forma de aprenderlo?

Paso 2

Hacé un cambio seguro

Querés practicar con el código de Instalar Git y publicar tu primer repositorio. ¿Qué cambio es mejor para comenzar?

Paso 3

Comprobá lo que ocurrió

Después de modificar un dato, ¿qué tenés que hacer para saber si aprendiste correctamente?

Paso 4

Tu mini proyecto

Tarea: abre el editor del navegador o el archivo completo. Cambiá un solo dato visible, ejecútalo y observa qué parte del resultado cambió.

Progreso del mini proyecto

Completá los cuatro pasos.

Aprende comprobando

🧪 Comprobaciones programando

Ejecutá un caso controlado y deja que el código compruebe condiciones importantes.

1. Caso normalUsá datos comunes.
2. Valor límiteProbá cero, vacío, máximo o mínimo.
3. Error esperadoComprobá que el mensaje ayude a corregirlo.
# macOS — Terminal
python3 --version
which python3
code --version
git --version

# Windows — PowerShell
# python --version
# where python
# code --version
# git --version
Qué estás aprendiendo: Cada comando debe mostrar una versión o ruta. Si no ocurre, la herramienta todavía no está lista.

Después de ejecutarlo

  • ¿Qué condición comprueba cada assert?
  • ¿Qué cambio hace fallar la comprobación?
  • ¿El mensaje explica qué tenés que corregir?
  • ¿Podés agregar otro caso?
Parte 5

Cerrá la lección

Comprobá que la herramienta funciona, marca el checklist y decide si continuar.

Parte 4

Comprobá lo que entendiste

Respondé una pregunta a la vez. Podés usar pistas y volver a intentarlo.

Evaluación online

❓ Comprueba lo que entendiste

Respondé sobre Instalar Git y publicar el primer repositorio. Verás una explicación completa y podrás intentarlo nuevamente.

Pregunta 1 de 5 · Selección

¿Cuál describe mejor la entrada principal?

Pregunta 2 de 5 · Selección

¿Qué describe mejor el procesamiento?

Pregunta 3 de 5 · Selección

¿Qué error esperado debería manejarse?

Pregunta 4 de 5 · Respuesta breve

Pregunta 5 de 5 · Respuesta breve

Resultado de la evaluación

Completá las cinco preguntas.

✅ Checklist mejorado

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

Instalación

Marcá cada punto solamente después de comprobarlo.

Seguridad

Marcá cada punto solamente después de comprobarlo.

Publicación

Marcá cada punto solamente después de comprobarlo.

Comprensión

Marcá cada punto solamente después de comprobarlo.

Cómo podrás mejorar este proyecto

🚀 Mejoras futuras y dónde las aprenderás

No son obligatorias ahora. Son mejoras que aplicarás cuando aprendas las herramientas correspondientes.

Separar la configuración del código

Qué mejora: Evita editar el programa cuando cambia una ruta, clave o preferencia.

Dónde lo aprenderás: en la lección «Protege tokens con .env», del nivel APIs y servicios externos.

Añadir pruebas automatizadas

Qué mejora: Comprueba que una modificación no rompa lo existente.

Dónde lo aprenderás: en la lección «Escribe pruebas unitarias», del nivel Testing y despliegue.

Registrar la ejecución

Qué mejora: Ayuda a entender fallos sin imprimir datos sensibles.

Dónde lo aprenderás: en la lección «Configura observabilidad», del nivel Testing y despliegue.

Mejorar mensajes y validación

Qué mejora: Explica qué dato falta y cómo corregirlo.

Dónde lo aprenderás: en la lección «Entrada de datos segura», del nivel Fundamentos de Python.

Documentar decisiones y limitaciones

Qué mejora: Permite que otra persona comprenda y evalúe el proyecto.

Dónde lo aprenderás: en la lección «Construye casos de estudio», del nivel Portafolio profesional.

Crear una demostración

Qué mejora: Muestra el problema, funcionamiento y evidencia.

Dónde lo aprenderás: en la lección «Crea un índice HTML», del nivel Portafolio profesional.