Tu primer programa en Python con un asistente

Programar es escribir instrucciones tan precisas que una máquina las pueda seguir sin preguntar nada. Piensa en una receta de sancocho: si escribes "le echa papa", una persona entiende; un computador no. Él necesita: cuántas papas, en qué momento, en qué olla. El computador nunca adivina ni completa lo que faltó. Eso, que al principio suena molesto, es en realidad la buena noticia: no hay magia escondida, todo lo que pasa está escrito en alguna parte.

El idioma que vamos a usar se llama Python. Un lenguaje de programación es un conjunto de palabras y reglas que la máquina sabe traducir a instrucciones. Python se escogió para este curso porque su forma de escribirse se parece bastante al inglés cotidiano, porque perdona más errores de principiante que otros lenguajes, y porque es el lenguaje dominante en inteligencia artificial y análisis de datos. Lo que aprendas aquí te sirve directamente para las lecciones siguientes del curso.

Y vas a tener un asistente de IA al lado: un programa (Gemini, ChatGPT, Claude, en sus versiones gratuitas) que genera texto y código a partir de lo que le pides en español. El asistente te va a ahorrar horas de buscar en foros en inglés. Pero ojo con esto, porque es la regla más importante de toda la lección:

• El asistente se equivoca con seguridad. Puede inventar funciones que no existen; a eso se le llama alucinación.
• El asistente no sabe si su código funciona: no lo ejecutó. Tú sí lo vas a ejecutar.
• Regla de la casa: no ejecutes código que no puedas explicar en voz alta. Si no lo entiendes, pídele al asistente que te lo explique línea por línea antes de correrlo.

Usar IA para programar no es hacer trampa. Hacer trampa es entregar algo que no entiendes.

Instalar Python en tu computador se puede hacer, pero ahí es donde se rinde la mayoría de la gente: versiones, rutas, permisos, un error rarísimo y adiós. Nos lo vamos a saltar. Vamos a usar Google Colab, una herramienta gratuita de Google donde escribes Python en el navegador y el código se ejecuta en los computadores de Google, no en el tuyo. Sirve igual en un portátil viejito, en el computador de la biblioteca de la universidad o en un celular Android con Chrome.

Lo que necesitas: una cuenta de Google (la misma del correo) y conexión a internet. Entra a colab.research.google.com y elige Archivo → Nuevo cuaderno. Lo que se abre se llama un cuaderno (o notebook): una hoja hecha de bloques llamados celdas.

• Una celda de código es donde escribes Python. Tiene un botón de play (▶) a la izquierda.
• Una celda de texto es para escribir notas en español, como en un cuaderno de clase. Úsala: escribe con tus palabras qué hace cada bloque.
• Para ejecutar una celda: haz clic en ▶, o presiona Shift + Enter (ejecuta y baja a la siguiente).

La primera vez que ejecutes algo, Colab tarda unos segundos: está prendiendo una máquina para ti. Verás un círculo girando y luego un número entre corchetes, así [1], que indica el orden en que se ejecutaron las celdas. Ese numerito te va a salvar la vida más adelante.

Dos advertencias honestas. Primera: si dejas el cuaderno quieto mucho rato, Colab se desconecta y se borra todo lo que la máquina tenía guardado en memoria; el código escrito no se pierde, pero toca volver a ejecutar las celdas desde arriba. Segunda: el cuaderno se guarda en tu Google Drive, así que lo que escribas ahí queda en un servidor de Google. No pongas datos personales sensibles, ni tuyos ni de nadie: ni cédulas, ni historias clínicas, ni contraseñas.

En la primera celda escribe esto a mano (no lo copies: escribirlo se te queda en los dedos) y presiona Shift + Enter:

nombre = input("¿Cómo te llamas? ")
print(f"Hola, {nombre}. Este es tu primer programa.")

Aparecerá una cajita esperando que escribas tu nombre. Escríbelo, presiona Enter y verás el saludo. Ya programaste. Ahora lo importante: entender qué pasó.

• input("...") es una función: un pedacito de código ya hecho que hace una tarea cuando lo llamas por su nombre y le pasas algo entre paréntesis. Esta muestra el mensaje, espera a que escribas y te devuelve lo que escribiste.
• nombre es una variable: una cajita con etiqueta donde guardas un dato para usarlo después. El signo = no significa "es igual a", significa "guarda esto adentro de". Se lee de derecha a izquierda.
• print(...) muestra en pantalla lo que le pases.
• La f antes de las comillas crea una f-string: dentro del texto, lo que pongas entre llaves {} se reemplaza por el valor de esa variable. Sin la f, se imprimiría literalmente {nombre}.

Ahora algo más útil. En una celda nueva:

trm = float(input("Escribe la TRM de hoy en pesos: "))
dolares = float(input("¿Cuántos dólares quieres convertir? "))
pesos = dolares * trm
print(f"{dolares} dólares equivalen a {pesos:,.0f} pesos")

Aquí hay algo nuevo y clave: input() siempre te devuelve texto, aunque escribas números. Y multiplicar textos no tiene sentido. Por eso envolvemos el resultado en float(), que convierte ese texto en un número con decimales. El * multiplica. Y :,.0f dentro de las llaves es formato: sin decimales y con separador de miles.

Un detalle colombiano: Python usa la coma como separador de miles al estilo estadounidense, así que verás 4,000,000 donde en Colombia escribiríamos 4.000.000. No es un error del programa; es una convención distinta, y en la lección 4 aprenderás a cambiarla.

Un asistente de IA responde mucho mejor cuando le das contexto, objetivo y restricciones. Un pedido vago ("hazme un programa en Python") produce código genérico que no sabes correr. Un pedido bien armado produce algo que puedes pegar en Colab y entender.

La estructura que funciona tiene cuatro partes:

1. Quién eres: "soy principiante absoluto, nunca he programado". 2. Qué quieres: describe el resultado, no la solución técnica. 3. Dónde va a correr: "lo voy a ejecutar en Google Colab". 4. Cómo lo quieres: "usa solo Python básico, sin librerías externas, y explícame cada línea en español con comentarios".

Ese último punto es el que convierte a la IA en profesor y no en máquina de respuestas. Un comentario es una línea que empieza con #: Python la ignora por completo, está ahí para que la lea un humano.

Después de que la IA te responda, haz siempre estas tres cosas, en este orden:

• Ejecuta el código. Si no corre, la explicación más bonita del mundo no vale nada.
• Pídele que te interrogue. Escribe: "hazme tres preguntas sobre este código para verificar si lo entendí, y no me des las respuestas todavía".
• Desconfía de lo raro. Si aparece una librería que nunca mencionaste o una función con nombre extraño, pregunta: "¿esa función existe realmente en Python? Muéstrame qué hace con un ejemplo mínimo". Si la inventó, el ejemplo mínimo va a fallar al ejecutarlo, y ahí lo cazas.

Y cuando algo falle, nunca escribas "no funciona". Pega el mensaje de error completo, tal cual, más el código que lo produjo. La IA no ve tu pantalla: solo sabe lo que le escribes. Con el error completo acierta casi siempre; con "no me sirve" adivina, y adivinar mal te hace perder media hora.

Los errores no son castigos: son el computador diciéndote exactamente dónde no te entendió. Vamos a provocar tres a propósito, en celdas nuevas, para que cuando aparezcan de verdad ya los conozcas.

Error 1 — SyntaxError. Quítale la comilla final:

print("Hola

Python responde algo como SyntaxError: unterminated string literal. Syntax es ortografía: escribiste algo que no es Python válido. Casi siempre es una comilla, un paréntesis o los dos puntos que faltan.

Error 2 — NameError. Ejecuta esto en un cuaderno recién abierto:

print(edad)

Responde NameError: name 'edad' is not defined. Estás pidiendo el contenido de una cajita que nunca creaste. Esta es la causa número uno de sufrimiento en Colab: si ejecutas las celdas en desorden, o si Colab se desconectó, las variables se borran de la memoria y el programa reclama por algo que "tú ya escribiste"... pero que la máquina ya no tiene.

Error 3 — TypeError. Prueba:

edad = input("¿Cuántos años tienes? ")
print(edad + 10)

Responde TypeError: can only concatenate str (not "int") to str. Traducido: estás intentando sumar texto con número. Recuerda que input() devuelve texto. Se arregla con edad = int(input("...")), donde int() convierte a número entero.

Cuando el error es largo, ese bloque rojo se llama traceback. Léelo de abajo hacia arriba: la última línea dice el tipo de error y el mensaje, y justo encima aparece la línea de tu código que lo causó, marcada con una flecha. El resto casi siempre es tubería interna de Python que no necesitas entender hoy.

Método para arreglar, en orden: lee la última línea, mira la línea señalada, y si sigues perdido pega error y código en el asistente pidiendo "explícame este error como si tuviera 12 años y dime qué línea cambio".