Clase 23: Flask - Instalación y primer Hola Mundo
Flask: Instalación y primer “Hola Mundo”
Hoy vamos a usar el entorno que creamos para instalar nuestra primera herramienta de desarrollo web: Flask.
La idea de la clase es simple: instalarlo, levantar un servidor y ver una página en el navegador. Sin formularios, sin archivos, sin complicaciones. Primero que funcione; después, que crezca.
1. ¿Qué es Flask?
Definición simple: Flask es un framework web para Python. Nos permite crear aplicaciones que responden a peticiones HTTP (como cuando escribís una dirección en el navegador) sin tener que programar toda la comunicación desde cero.
Framework vs. librería (la diferencia importa)
| Concepto | Qué es | Ejemplo |
|---|---|---|
| Librería | Vos llamás al código. Vos tenés el control. | requests, json |
| Framework | El framework llama a tu código. Él tiene el control del flujo. | Flask, Django |
Analogía: una librería es como una caja de herramientas: la usás cuando querés. Un framework es como una casa ya construida con las paredes y las puertas puestas: vos decidís qué poner en cada habitación, pero el recorrido ya está definido.
¿Por qué Flask y no otra cosa?
| Característica | Flask |
|---|---|
| Tamaño | Microframework: chico, pocas reglas |
| Curva de aprendizaje | Suave: el “Hola Mundo” entra en 6 líneas |
| Flexibilidad | Total: vos elegís qué agregar |
| Servidor incluido | Sí, para desarrollo (no para producción) |
| Python requerido | 3.9 o superior (nosotros usamos 3.13.x) |
2. Antes de instalar: el entorno virtual
Regla de la clase anterior: las librerías de un proyecto van dentro de su entorno virtual, nunca en el Python del sistema.
# 1. Ir a la carpeta del proyecto
cd ~/proyectos/mi_primera_web
# 2. Crear el entorno (solo la primera vez)
python3 -m venv venv
# 3. Activarlo (SIEMPRE antes de instalar o ejecutar)
source venv/bin/activate # Debian
.\venv\Scripts\Activate.ps1 # Windows (PowerShell)
El prompt tiene que mostrar (venv):
(venv) ramses@debian:~/proyectos/mi_primera_web$
Si no ves
(venv), no sigas. Todo lo que instales irá al sistema y después vienen los problemas.
Estructura de la carpeta
mi_primera_web/
├── venv/ ← entorno virtual (no se comparte)
├── app.py ← nuestro archivo (lo creamos ahora)
└── requirements.txt ← receta de dependencias (lo generamos al final)
3. Instalar Flask
Con el entorno activado:
pip install flask
Salida esperada (las versiones pueden variar):
Collecting flask
Downloading flask-3.1.2-py3-none-any.whl
Collecting Werkzeug>=3.1.0
Collecting Jinja2>=3.1.2
...
Successfully installed Jinja2-3.1.6 MarkupSafe-3.0.2 Werkzeug-3.1.3 blinker-1.9.0 click-8.3.0 flask-3.1.2 itsdangerous-2.2.0
¿Por qué instaló 7 paquetes si pedí uno? Porque Flask depende de otros paquetes (Werkzeug, Jinja2, etc.).
piplos instala automáticamente. A eso se le llama dependencias transitivas.
Verificar la instalación
python -c "import flask; print(flask.__version__)"
# 3.1.2
pip show flask
# Name: Flask
# Version: 3.1.2
# Location: /home/ramses/proyectos/mi_primera_web/venv/lib/python3.13/site-packages
Dato clave: fijate en
Location. Si la ruta contienevenv, la instalación fue dentro del entorno. Si dice/usr/lib/python3/..., algo falló (probablemente no activaste el venv).
Guardar la receta
pip freeze > requirements.txt
Así, si mañana se borra el entorno, lo reconstruís con:
pip install -r requirements.txt
4. El “Hola Mundo” de Flask
Creá un archivo llamado app.py en la carpeta del proyecto:
# app.py
from flask import Flask
# Creamos la aplicación. __name__ le indica a Flask dónde está este archivo.
app = Flask(__name__)
# Cuando alguien visite la ruta "/", se ejecuta la función de abajo.
@app.route("/")
def inicio():
return "¡Hola Mundo desde Flask!"
# Esto hace que el servidor arranque solo si ejecutamos este archivo directamente.
if __name__ == "__main__":
app.run(debug=True)
5. Explicación línea por línea
from flask import Flask
Importa la clase Flask desde el paquete que instalamos con pip.
Es lo mismo que hicimos con from modelos.juego import Juego: traer una clase para usarla.
app = Flask(__name__)
Crea la aplicación. app es un objeto de la clase Flask (¡POO otra vez!).
El __name__ le dice a Flask desde qué archivo se está ejecutando, para que pueda ubicar recursos como plantillas o archivos estáticos.
¿Qué es
__name__? Es una variable que Python crea solo en cada archivo. Si el archivo se ejecuta directamente, vale"__main__"; si se importa desde otro, vale el nombre del módulo. Es la primera vez que la usamos, pero es una convención estándar en Python.
@app.route("/")
Esta línea es la que conecta una dirección con una función:
“Cuando llegue una petición a
/, ejecutá la función que está justo debajo.”
Ese @ es un decorador. Todavía no lo estudiamos en profundidad: por ahora alcanza con entender que modifica el comportamiento de la función que sigue sin que tengamos que cambiar su código.
| Parte | Significado |
|---|---|
@app.route |
“Registrá una ruta en esta aplicación” |
"/" |
La dirección: la raíz del sitio (http://127.0.0.1:5000/) |
def inicio(): |
La función que responde a esa dirección |
return "¡Hola Mundo desde Flask!"
Lo que la función devuelve es lo que el navegador recibe. En este caso, texto plano. Más adelante veremos cómo devolver HTML completo.
app.run(debug=True)
Arranca el servidor de desarrollo. debug=True activa dos cosas muy útiles:
- Recarga automática: al guardar
app.py, el servidor se reinicia solo. - Mensajes de error detallados en el navegador.
⚠️ Importante:
debug=Truees solo para desarrollo. En producción (cuando el sitio está publicado) debe ir enFalse, porque muestra información interna del código.
if __name__ == "__main__":
Evita que el servidor arranque si el archivo se importa desde otro lado.
Si ejecutamos python app.py, __name__ vale "__main__" y el servidor arranca.
6. Ejecutar el servidor
python app.py
Salida esperada:
* Serving Flask app 'app'
* Debug mode: on
WARNING: This is a development server. Do not use it in a production deployment.
* Running on http://127.0.0.1:5000
Press CTRL+C to quit
* Restarting with stat
* Debugger is active!
Abrí el navegador en http://127.0.0.1:5000 (o http://localhost:5000) y vas a ver:
¡Hola Mundo desde Flask!
¿Qué significan esos números?
127.0.0.1→ “esta misma máquina” (localhost).5000→ el puerto, la “puerta” por donde el servidor escucha. Flask usa 5000 por defecto.
Para detener el servidor: Ctrl + C en la terminal.
7. ¿Qué pasa por dentro?
Navegador Servidor Flask
───────── ──────────────
GET / ──────────────► busca una ruta que coincida con "/"
│
▼
ejecuta inicio()
│
▼
"¡Hola Mundo..." ◄────────────── devuelve el texto como respuesta
- El navegador pide
GET /. - Flask busca en su tabla de rutas cuál coincide con
/. - Encuentra
inicio()y la ejecuta. - El valor que devuelve se envía al navegador.
- El navegador lo muestra.
Si la ruta no existe, Flask responde 404 Not Found. Probalo: entrá a http://127.0.0.1:5000/cualquiercosa.
8. Agregar una segunda ruta
Un sitio con una sola página es aburrido. Sumemos otra ruta a app.py:
@app.route("/acerca")
def acerca():
return "Página acerca de mi primer sitio con Flask"
Guardá el archivo (con debug=True el servidor se reinicia solo) y visitá:
http://127.0.0.1:5000/acerca
Cada ruta = una función. Si dos funciones usan la misma ruta, Flask se queda con la primera y avisa del conflicto.
9. Errores comunes
| Síntoma | Causa | Solución |
|---|---|---|
ModuleNotFoundError: No module named 'flask' |
El entorno no está activado o Flask se instaló en otro lado | source venv/bin/activate y pip install flask de nuevo |
Address already in use / puerto ocupado |
Ya hay un servidor corriendo en el puerto 5000 | Ctrl + C en la otra terminal, o usar app.run(debug=True, port=5001) |
| La página no cambia al guardar | debug=True no está activo o el servidor no recargó |
Reiniciar con Ctrl + C y python app.py |
404 Not Found |
La ruta no existe o está mal escrita | Revisar que el @app.route coincida exactamente con la URL |
externally-managed-environment (Debian) |
Intentaste instalar fuera del entorno | Activar el venv y reinstalar |
| El navegador no conecta | El servidor no está corriendo | Verificar la terminal: debe decir Running on... |
| Puerto 5000 usado por otro servicio (macOS) | AirPlay Receiver ocupa el 5000 | Usar otro puerto: port=5001 |
Actividades
Actividad 1: Tu primer servidor
- Creá la carpeta
clase23_flasky dentro un entorno virtual. - Activá el entorno e instalá Flask.
- Creá
app.pycon el “Hola Mundo” de la clase, pero cambiá el mensaje por uno propio que incluya tu nombre. - Ejecutá el servidor y verificá en el navegador.
- Generá el
requirements.txtconpip freeze.
Entregá: una captura del navegador mostrando tu mensaje, otra de la terminal con el servidor corriendo, y el contenido de requirements.txt.
Para pensar (respondé en una línea): ¿por qué el mensaje cambió sin tocar el navegador, solo modificando
app.py?
Actividad 2: Dos rutas y un 404
Partiendo del app.py de la actividad 1:
- Agregá una ruta
/sobre-mique devuelva un texto con tu nombre, tu curso y la materia. - Agregá una ruta
/materiaque devuelva el nombre del módulo y el año. - Verificá las tres rutas en el navegador (
/,/sobre-mi,/materia). - Entrá a una dirección que no exista, por ejemplo
/no-existe, y observá la respuesta.
Entregá: el código final de app.py y una captura del error 404. Respondé: ¿qué relación hay entre cada @app.route(...) y la función que está debajo?
Pista: no hace falta HTML todavía. Cada función puede devolver un string simple. Si querés separar visualmente, podés usar
\ndentro del texto.
Resumen de la clase
| Concepto | Idea para llevarte |
|---|---|
| Flask | Microframework web para Python |
| Instalar | pip install flask (con el venv activado) |
| Aplicación | app = Flask(__name__) |
| Ruta | @app.route("/direccion") + función que devuelve la respuesta |
| Ejecutar | python app.py → http://127.0.0.1:5000 |
| Detener | Ctrl + C |
| Debug | debug=True recarga solo y muestra errores detallados (solo en desarrollo) |
| 404 | La ruta pedida no existe |
| Receta | pip freeze > requirements.txt |
Antes de la próxima entrega: acostumbrate a este ciclo — activar el entorno → ejecutar → probar en el navegador →
Ctrl + C. Es el mismo ciclo que vas a repetir en cada proyecto.
o/