Git desde cero

Hola! Bienvenida a este libro 🌸

Esto no es un artículo largo: son capítulos que se leen en orden, con ejercicios en cada uno y con todos los comandos ejecutados de verdad.

Eso último importa más aquí que en mis otros libros. En un libro de Git es facilísimo escribir una salida de memoria y que no sea la que sale: cambió la versión, cambió el mensaje, y el libro sigue prometiendo algo que ya no ocurre. Aquí cada bloque corre en un repositorio de verdad antes de publicarse, y una prueba lo comprueba en cada cambio 🔍

Para quién es

Para ti si te pasa alguna de estas:

Ves proyectos de IA compartidos en GitHub y no sabes cómo bajarlos ni cómo usarlos.
Tienes una carpeta con seis versiones del mismo archivo y ya no sabes cuál es la buena.
Alguien te pidió un pull request y sonreíste sin saber qué era.
Empezaste a usar Claude Code o alguna herramienta de IA y todo lo que quieres probar vive en un repositorio.

No necesitas saber programar. Sí necesitas estar dispuesta a escribir en la terminal, que es más fácil de lo que parece y en el capítulo 2 te acompaño 🐣

Qué vas a poder hacer al terminar

Bajar cualquier proyecto que encuentres y hacerlo funcionar. Mirar un repositorio desconocido y decidir en dos minutos si sirve o está abandonado. Publicar lo tuyo. Proponer un cambio en el proyecto de otra persona. Y recuperar tu trabajo el día que creas que lo perdiste, que ese día llega.

El repositorio que vamos a construir

Todo el libro trabaja sobre el mismo proyecto, ventas-miss-yera, con las ventas de Lima, Arequipa, Trujillo y Cusco que ya conoces si leíste mis otros libros. Empieza en el capítulo 3 con cuatro comandos y termina publicado.

Una cosa antes de empezar

Los códigos raros que vas a ver en las salidas, esos de siete letras y números como 54da6e2, se llaman hashes y son el nombre de cada momento guardado. Los míos y los tuyos no van a coincidir, porque salen de mezclar lo guardado con quién eres y qué hora era.

Lo digo ahora porque es la duda que más recibo: "me salió distinto al del libro, ¿hice algo mal?". No. Lo que tiene que coincidir es la forma 🙂

Si te falta base

🐍 Python desde cero, si además del repositorio quieres entender el código que hay dentro.
🗄️ SQL desde cero, porque los datos casi nunca llegan en CSV.
🤖 Ingeniería de IA en producción, si ya usas IA todos los días y quieres construir algo que puedas entregar y defender.

Los cuatro comandos que resuelven el 90%

Para que veas de qué va esto, el libro entero se apoya en cuatro comandos. Estos:

git init            # esta carpeta ahora tiene memoria
git status          # qué hay pendiente
git add ventas.csv  # señalo qué quiero guardar
git commit -m "Primeras ventas de Lima"   # guardo el momento

Con esos cuatro ya puedes trabajar. Todo lo demás del libro son formas de mirar la historia, de deshacer, de compartir y de recuperar lo que creías perdido 🧰

El temario, en seis partes

1. Por qué existe. El problema de la carpeta con seis versiones, dejar tu máquina lista y tu primer repositorio.

2. El día a día. Es el 95% de lo que vas a usar: dónde vive un archivo antes de quedar guardado, escribir commits que se entiendan, leer la historia, deshacer sin romper nada, por qué tu repositorio pesa quinientos megas, ramas y conflictos.

3. GitHub. Aquí está lo que la gente me pide: qué es GitHub y qué no, la llave para entrar, bajar un proyecto y hacerlo funcionar, mirar un repositorio desconocido y saber si sirve, qué te deja hacer una licencia, publicar lo tuyo, escribir un README y publicar una web gratis.

4. Trabajar con gente. Proponer un cambio en el proyecto de otra persona, pedir ayuda, trabajar sin pisarse, revisar el trabajo ajeno y marcar versiones.

5. Cuando se rompe. Recuperar lo perdido, encontrar en qué momento se rompió, reescribir la historia sin quemar al equipo y qué hacer el día que subes una clave sin querer.

6. Git en 2026. Qué hay dentro de la carpeta oculta, por qué Git es el cinturón de seguridad cuando trabajas con IA, cómo hacer que GitHub trabaje mientras duermes, y el proyecto final.

Cómo leerlo

En orden y con la terminal abierta. No sirve de mucho leerlo en el bus: cada capítulo tiene comandos que hay que escribir, y la memoria de esto está en los dedos más que en la cabeza.

Si algo te falla, casi siempre es una de tres: estás en otra carpeta, el nombre del archivo está mal escrito, o se te olvidó el git add. Las tres se descubren con git status, que es el comando que más vas a escribir en tu vida 🔎

La trampa

Llevas dos semanas trabajando en el análisis de las ventas, todo va bien, y un lunes decides ordenar la carpeta antes de mandarle el avance a tu jefa.

$ ls
analisis.py  ventas.csv  .git

$ rm -rf .git   # esto se ve raro, lo borro
$ git log

fatal: not a git repository (or any of the parent directories): .git

Qué está mal

Esa carpeta con punto delante no era basura: era el repositorio entero 😱

Los archivos siguen ahí, no perdiste el trabajo de hoy. Lo que perdiste son las dos semanas de historia: cada commit, cada mensaje, cada versión anterior de ventas.csv. Y eso no se recupera, porque Git guardaba todo eso ahí dentro y en ningún otro sitio.

Es el accidente más común de quien recién empieza, y por eso lo pongo antes del capítulo 1: todo lo que empieza con punto está oculto a propósito, y casi siempre es importante.

La única vacuna de verdad es tener una copia en GitHub. Con eso, borrar la carpeta local deja de ser un desastre y pasa a ser un mal rato.

Comprueba que se entendió

Comprueba que lo tienes

Tienes un repositorio en tu laptop con seis meses de trabajo. Se te cae al piso y no enciende. ¿Qué pasó con tu historia?

Está a salvo, Git guarda todo en la nube
Se perdió, salvo que tuvieras una copia en GitHub o en otro sitio
Se recupera instalando Git otra vez en la laptop nueva
Se recupera con el correo que configuraste

Preguntas frecuentes

¿Necesito saber programar para aprender Git?

No. Git sirve para cualquier carpeta con archivos de texto: tus consultas SQL, tus notas, un CSV con las ventas de Lima o la propuesta de un cliente. La mayoría de la gente que llega hoy a GitHub no programa, llega porque las herramientas de IA que quiere usar viven ahí.

¿Cuál es la diferencia entre Git y GitHub?

Git es un programa que corre en tu computadora y no necesita internet. GitHub es una página donde puedes dejar una copia de tu repositorio para compartirlo o para tenerlo a salvo. Puedes usar Git toda tu vida sin GitHub, y es la confusión que más veo al principio.

¿Git es una copia de seguridad de mi trabajo?

No por sí solo. Git guarda la historia en la misma computadora, así que si se malogra el disco se pierde todo. Lo que sí es una copia es tener el repositorio subido a GitHub, y por eso los dos temas van juntos en este libro.

¿Sirve para archivos de Word o Excel?

A medias. Git guarda cualquier archivo, pero solo sabe decirte qué línea cambió cuando el archivo es de texto. Con un Word te dirá que cambió, no qué cambió. Por eso en el mundo de los datos se trabaja con CSV y no con Excel cuando el archivo va a un repositorio.

¿Cuánto tiempo toma aprender lo básico?

Los cuatro comandos del principio se aprenden en una tarde. Lo que toma más es perderle el miedo, y eso llega el día que rompes algo, lo recuperas y descubres que Git casi nunca borra nada de verdad.

Nos vemos en el capítulo 1. Que tengas un hermoso día! 🌟