Manual de la sesión — crearás tu repositorio desde cero, guardarás tus primeros cambios con git add y git commit, y los publicarás con git push.
Esta sesión continúa exactamente donde terminó la anterior: hoy tú produces y publicas. No repetiremos los pasos de instalación ni los de la clase 2; verifica esta lista y, si te falta algo, resuélvelo antes de la clase por el canal de ayuda.
git config --global --list debe mostrar tu user.name y tu user.email; si no aparecen, resuélvelo con la sección G antes de venir.Documentos/propedeutico y tu entorno .venv creado. Si faltaste o algo quedó a medias, sigue el Manual de la clase 2.git add coloca tus cambios en la «bandeja de preparación». Solo lo que está en la bandeja entra en el próximo commit.git push los sube a GitHub, donde quedan respaldados y visibles. Es el gesto inverso al git pull con que bajas los materiales del curso.propedeutico de tus Documentos — la carpeta madre de la clase 2, donde ya vive propedeutico-flacso.mi-propedeutico — minúsculas, sin espacios, tildes ni eñes: la regla de oro de la clase 2 también aplica aquí.Documentos/propedeutico/ ├── propedeutico-flacso/ ← el del curso: solo lees y haces git pull └── mi-propedeutico/ ← el tuyo: vacío por ahora — hoy lo llenas
propedeutico, como hermana de propedeutico-flacso — nunca adentro. Si quedó anidada, revisa P6 para moverla.Ahora ábrela en VS Code: File → Open Folder (Archivo → Abrir carpeta) → mi-propedeutico → confía en los autores (eres tú). El explorador de VS Code se verá vacío — correcto: todavía no hay nada.
mi-propedeutico — el mismo nombre que la carpeta del paso 1.Bitácora del propedéutico — FLACSO Ecuador.Como el repositorio está vacío, GitHub no te muestra archivos sino una página de Quick setup con instrucciones. Localiza el bloque titulado …or create a new repository on the command line: son los comandos que usarás en el siguiente paso, ya con tu nombre de usuario en la dirección. Deja esta pestaña abierta.
Fíjate en la dirección del navegador: github.com/tu-usuario/mi-propedeutico. Ese es tu espacio público; el del curso era el del docente.
mi-propedeutico, la terminal nace «parada» exactamente ahí. Compruébalo: la ruta antes del cursor debe terminar en mi-propedeutico.cd: así se mueve uno por las carpetas
La terminal siempre está parada en una carpeta, y los comandos actúan ahí. Para moverte se usa cd (change directory): escribe cd, un espacio y la ruta de la carpeta destino. Un truco que no falla: escribe cd y arrastra la carpeta desde el explorador o el Finder hasta la terminal — la ruta se escribe sola; presiona Enter y confirma dónde quedaste con pwd. Hoy VS Code te ahorra el viaje: al abrir mi-propedeutico como carpeta de trabajo, su terminal ya nace parada ahí.echo "# mi-propedeutico" >> README.md
git init
git add README.md
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/tu-usuario/mi-propedeutico.git
git push -u origin main
Siete líneas que hacen todo el trabajo de fundación. Léelas antes de ejecutarlas — cada una tiene un oficio:
| Comando | Su oficio |
|---|---|
echo "# mi-propedeutico" >> README.md | Crea el archivo README.md con una línea de título — la portada de tu repositorio. |
git init | Convierte la carpeta en un repositorio Git: nace el álbum donde se guardarán las fotografías. |
git add README.md | Prepara el archivo para la primera fotografía. |
git commit -m "first commit" | La toma: el primer commit de tu historial. |
git branch -M main | Nombra main a la rama principal del historial (y de paso resuelve el aviso hint: que quizá imprimió git init). |
git remote add origin … | Anota la dirección de tu repositorio en GitHub bajo el alias origin — por eso esta línea lleva tu usuario. |
git push -u origin main | Publica: sube el commit a GitHub. El -u deja la ruta memorizada; desde ahora bastará git push. |
~/Documentos/propedeutico/mi-propedeutico> (pegas el bloque y presionas Enter) Initialized empty Git repository in .../mi-propedeutico/.git/ [master (root-commit) f7a8b9c] first commit ← dirá master (o main); la línea git branch -M main la renombra enseguida 1 file changed, 1 insertion(+) create mode 100644 README.md … (aquí te identificas con GitHub — ver aviso arriba) … Writing objects: 100% (3/3), 230 bytes | 230.00 KiB/s, done. To https://github.com/tu-usuario/mi-propedeutico.git * [new branch] main -> main branch 'main' set up to track 'origin/main'.
¿Alguna línea falló a medio camino? Identifica cuál por su mensaje: «Please tell me who you are» → P1; la autorización no llega o falla → P2 y P3; «remote origin already exists» → P6; «rejected … fetch first» → P8. Resuelto el problema, repite desde la línea que falló (normalmente git commit -m "first commit" y git push -u origin main).
Vuelve a la pestaña de GitHub y actualiza la página (F5 / ⌘R). La página de Quick setup desapareció: en su lugar está tu repositorio de verdad, con README.md mostrando el título mi-propedeutico y el contador marcando 1 commit — tu «first commit», con tu nombre y tu fecha.
Detente un segundo en lo que acaba de pasar: la carpeta de tu computadora y esta página son el mismo repositorio, conectados. Todo lo que fotografíes con commit y empujes con push aparecerá aquí. Vamos a comprobarlo creando tu primer archivo de verdad.
bitacora.md — el nombre sin tildes; el contenido puede llevarlas con total normalidad. Debe quedar al mismo nivel que README.md (el archivo que creó la línea echo del paso 3).# Bitácora del propedéutico ## Clase 3 — 15 de julio de 2026 Hoy creé mi primer repositorio y aprendí el ciclo editar → add → commit → push.
bitacora.md en VS Code: mientras muestre un punto ● en lugar de la ✕, lo que escribiste vive solo en la pantalla — en el disco todavía no existe, y para Git «no pasó nada». Al guardar con Ctrl+S / ⌘S el punto se convierte en ✕: recién entonces Git puede ver tu cambio. Hazlo reflejo: terminaste de escribir → Ctrl+S.Los archivos .md (Markdown) son texto plano con formato sencillo: # marca un título, ## un subtítulo. GitHub los muestra ya formateados — por eso el README de cualquier repositorio se ve «bonito».
git status — pregunta a Git qué veVuelve a la terminal del paso 3 (si la cerraste, abre otra: Terminal → New Terminal — nace parada en tu repositorio). git status no cambia nada: solo informa — úsalo todo el tiempo, antes y después de cada paso:
git status
~/Documentos/propedeutico/mi-propedeutico> git status On branch main Your branch is up to date with 'origin/main'. Untracked files: (use "git add <file>..." to include in what will be committed) bitacora.md nothing added to commit but untracked files present (use "git add" to track)
Cómo leerlo: untracked (en rojo) significa que Git ve el archivo nuevo pero todavía no lo vigila ni lo incluirá en ninguna fotografía. La propia salida te sopla el siguiente paso: git add.
git add — prepara la fotografíaColoca el archivo en la bandeja de preparación:
git add bitacora.md
No imprime nada si todo va bien. Comprueba con git status: el archivo ahora aparece en verde, listo para el commit:
~/Documentos/propedeutico/mi-propedeutico> git status On branch main Your branch is up to date with 'origin/main'. Changes to be committed: (use "git restore --staged <file>..." to unstage) new file: bitacora.md
💡 Más adelante usarás git add . (con punto) para preparar todos los cambios pendientes de una vez.
git commit — toma la fotografíaEl commit guarda lo preparado en el historial, con un mensaje entre comillas que explica el cambio:
git commit -m "Crea la bitacora del curso"
~/Documentos/propedeutico/mi-propedeutico> git commit -m "Crea la bitacora del curso" [main a1b2c3d] Crea la bitacora del curso 1 file changed, 6 insertions(+) create mode 100644 bitacora.md
git log será tu memoria — un historial de mensajes tipo «cambios» o «avance» no le dice nada a nadie, ni a ti. ¿Y por qué «Anade», sin tilde ni eñe? Git las acepta sin problema, pero muchos proyectos las evitan en los mensajes porque algunas terminales antiguas las muestran mal; sigue la costumbre que prefieras — en tus archivos, escribe siempre con ortografía normal.El -m es importante — la m de mensaje. Sin él, o si la letra sale mal (el typo clásico es -n), Git abre un editor para pedirte el mensaje (si te pasó, revisa P5).
git push — publica en GitHubHasta aquí, el commit existe solo en tu computadora. Súbelo:
git push
-u, ahora basta git push a secas — Git ya sabe la ruta. Si aun así te pide algo, revisa P2 y P3.~/Documentos/propedeutico/mi-propedeutico> git push Enumerating objects: 4, done. Counting objects: 100% (4/4), done. Delta compression using up to 8 threads Compressing objects: 100% (2/2), done. Writing objects: 100% (3/3), 428 bytes | 428.00 KiB/s, done. Total 3 (delta 0), reused 0 (delta 0), pack-reused 0 remote: Resolving deltas: 100% (0/0), done. To https://github.com/tu-usuario/mi-propedeutico.git f7a8b9c..a1b2c3d main -> main
Ahora ve al navegador, entra a github.com/tu-usuario/mi-propedeutico y actualiza la página: ahí está bitacora.md, y el contador dice 2 commits (el «first commit» del paso 3 y el de tu bitácora). El ciclo completo — editar, add, commit, push — acaba de funcionar de principio a fin, hecho por ti.
Lo que convierte esto en hábito es repetirlo. Edita bitacora.md — añade al final una línea nueva, por ejemplo «Publiqué mi primer repositorio.» — guarda con Ctrl+S / ⌘S, y recorre el ciclo entero:
git status git add . git commit -m "Anade la primera entrada de la bitacora" git push
Refresca tu repositorio en el navegador: la página muestra 3 commits. Pulsa sobre ese contador para ver tu historial — cada commit, con tu nombre, fecha y mensaje.
Este es el ciclo que repetirás toda la maestría: editar → git add → git commit → git push. Tu bitácora crecerá una entrada por clase; ese será tu ejercicio permanente.
Antes de cerrar la laptop, verifica que puedes marcar todo:
Tu tabla de consulta rápida de esta sesión. Los cuatro primeros son el ciclo diario; los dos últimos, tus aliados de consulta:
| Comando | Qué hace |
|---|---|
git status | Informa qué ve Git: archivos nuevos, modificados o preparados. No cambia nada. |
git add archivo · git add . | Prepara un archivo (o todos, con el punto) para el próximo commit. |
git commit -m "mensaje" | Guarda la fotografía en el historial, con tu nombre, la fecha y el mensaje. |
git push | Sube tus commits a GitHub. Hasta entonces, solo existen en tu computadora. |
git log --oneline | Muestra el historial resumido: un commit por línea. Sal con la tecla q si ocupa más de una pantalla. |
git pull | Baja las novedades desde GitHub — lo que haces en el repositorio del curso cada semana. |
Y, aparte, los cuatro comandos de fundación que usaste una sola vez en el paso 3. No hace falta memorizarlos: solo se ejecutan al crear un repositorio, y GitHub te los recuerda en su página de Quick setup cada vez que fundes uno nuevo:
| Comando | Qué hace |
|---|---|
git init | Convierte la carpeta actual en un repositorio Git. |
git branch -M main | Nombra main a la rama principal del historial. |
git remote add origin dirección | Conecta el repositorio local con su dirección en GitHub, bajo el alias origin. |
git push -u origin main | El primer push: publica y deja la ruta memorizada para que después baste git push. |
Git necesita saber quién toma la fotografía y falta tu identidad (sección G del Manual de instalación). Configúrala una sola vez, sustituyendo Nombre Apellido y tu-correo@ejemplo.com por tus datos reales:
git config --global user.name "Nombre Apellido" git config --global user.email "tu-correo@ejemplo.com"
Usa el mismo correo de tu cuenta de GitHub y repite el git commit.
Es el camino correcto: inicia sesión y pulsa Authorize. WIN Antes del navegador aparece una ventanita de Git Credential Manager — pulsa ahí Sign in with your browser. Si la terminal se queda esperando y no ves nada, mira la barra de tareas: a veces esa ventanita (o el navegador) se abre detrás de VS Code. MAC Busca el pequeño aviso de VS Code pidiendo permiso y pulsa Allow — el navegador se abre después. Ocurre solo la primera vez; después, git push pasa directo.
git push falla con “Authentication failed” o pide contraseña en la terminalGitHub ya no acepta tu contraseña escrita en la terminal. Si te la pidió, cancela con Ctrl+C y asegúrate de estar en la terminal integrada de VS Code (no en la Terminal del sistema). Repite el push que falló (en el paso 3 es git push -u origin main; en adelante, git push a secas) y esta vez acepta todo lo que aparezca: el aviso de VS Code pidiendo permiso (Allow) y la ventana del navegador (Authorize). Si sigue fallando, avisa al docente — se resuelve en un minuto y no es culpa tuya.
Casi siempre el archivo no está guardado: mira la pestaña en VS Code — un punto ● en lugar de la ✕ indica cambios sin guardar. Guarda con Ctrl+S / ⌘S y repite git status. Si ya estaba guardado, puede que estés en la carpeta equivocada: pwd debe terminar en mi-propedeutico.
-m (o escribí -n) y la terminal se convirtió en algo extrañoGit abrió un editor para pedirte el mensaje. Dos escenarios:
:q! y presiona Enter. Sales sin guardar y el commit se cancela.En cualquier caso, la próxima vez: git commit -m "mensaje".
Dos variantes del mismo despiste:
mi-propedeutico quedó dentro de propedeutico-flacso. Git se confunde con repositorios anidados, así que muévela: cierra VS Code y, con el explorador de archivos o el Finder, arrastra la carpeta completa hacia afuera, a Documentos/propedeutico, junto a la del curso. No se rompe nada — incluso si ya habías ejecutado los comandos del paso 3. Vuelve a abrirla desde VS Code.git remote add origin responde error: remote origin already exists — estabas dentro del repositorio del curso. Para dejarlo como estaba, ejecuta ahí mismo git reset --hard origin/main (devuelve el repositorio del curso exactamente a su estado publicado; ahí no debes tener cambios propios). Después abre tu carpeta correcta (File → Open Folder → mi-propedeutico) y repite el paso 3. Si dudas, pide ayuda al docente o usa la plantilla de IA de más abajo.El commit vive en tu computadora hasta que lo empujas: ejecuta git push y refresca la página. Si push responde Everything up-to-date, entonces no hay commits pendientes de subir — revisa git status: probablemente el cambio no pasó por add y commit.
Casi seguro marcaste Add a README file (o una licencia) al crear el repositorio: GitHub hizo un commit propio que tu historial local no conoce, y los dos historiales chocan. Como ese commit de GitHub es solo el README automático — nada tuyo —, lo más simple es sobrescribirlo:
git push -u origin main --force
--force le dice a Git «lo mío manda» y reemplaza lo que había en GitHub. Úsalo solo aquí, en tu repositorio recién nacido y tuyo — nunca en un repositorio compartido con otras personas.
Estoy siguiendo un manual del curso propedéutico de FLACSO y me atasqué en [paso o sección del manual donde estabas]. Mi sistema operativo es [Windows o Mac]. Escribí este comando o código: [pega aquí exactamente lo que escribiste] Y obtuve este mensaje de error o problema: [pega aquí el mensaje completo, copiado desde la terminal] Por favor: primero explícame por qué ocurre el problema, en lenguaje sencillo (no tengo experiencia en programación), y después dame los pasos para resolverlo, uno por uno.
Ya dominas los dos sentidos del tráfico: recibir con git pull (clase 2) y publicar con add → commit → push (hoy) — y además fundaste un repositorio desde cero, algo que mucha gente aprende bastante después. En la próxima sesión volvemos a los notebooks — algoritmos, tipos de variables y operadores en Python — y tu bitácora empieza a trabajar: al final de cada clase, escribe una entrada nueva y publícala. Ese pequeño ritual es tu respaldo, tu registro de avance y el primer contenido de tu portafolio público.
Y para consolidar la vista de conjunto, lee el Mapa de las herramientas: qué hace (y qué no hace) cada pieza del taller, el semáforo de señales de VS Code y los errores de siempre con su remedio. Es el manual de consulta del resto del curso.