Flask 'Hola Mundo'

1 Introducción a Flask

Flask es un framework web WSGI ligero para Python. Te proporciona lo esencial (enrutamiento, manejo de solicitudes/respuestas, plantillas (a través de Jinja2) y un sólido ecosistema de extensiones) sin la carga de una plataforma de pila completa.

Por qué la gente recurre a Flask:

Núcleo mínimo con extensiones que ofrecen funcionalidades adicionales.
Diseño de proyecto flexible, desde un solo archivo hasta aplicaciones modulares.
Código legible y accesible.
Listo para producción cuando se combina con un servidor WSGI como Gunicorn.

Haz clic en "Siguiente" para configurar tu entorno.

2 Prerrequisitos: Python y pip

Instala Python 3.8 o superior, luego confirma con:

python --version

¿Necesitas Python? Descárgalo desde python.org.

3 Crear un entorno virtual

Aísla las dependencias con un entorno virtual.

python -m venv .venv

Actívalo:

# macOS/Linux
source .venv/bin/activate

# Windows (Símbolo del sistema)
.venv\Scripts\activate

Verás (.venv) en tu prompt cuando esté activo.

4 Instalar Flask

Con tu entorno virtual activo, instala Flask.

pip install Flask

Confirma la instalación:

pip list | grep -i flask

5 Escribe una aplicación Flask mínima

Crea un archivo llamado app.py con este contenido:

from flask import Flask

app = Flask(__name__)

@app.get("/")
def hello():
    return "Hello from Flask!"

@app.get("/hello/")
def hello_name(name: str):
    # Convertidores de URL: string, int, float, path (por defecto es string)
    return f"Hello, {name}!"

if __name__ == "__main__":
    # Solo para desarrollo local
    app.run(host="127.0.0.1", port=5000, debug=True)

Los decoradores de ruta mapean métodos HTTP a funciones de Python. El segmento entre corchetes captura un parámetro de ruta.

6 Ejecuta la aplicación

Inicia el servidor de desarrollo:

python app.py

Deberías ver una salida que apunta a http://127.0.0.1:5000. La terminal se bloqueará; detenla con Ctrl+C.

7 Prueba los endpoints

Abre tu navegador:

http://127.0.0.1:5000/ — “Hello from Flask!”
http://127.0.0.1:5000/hello/Flask — “Hello, Flask!”

También puedes usar curl:

curl http://127.0.0.1:5000/
curl http://127.0.0.1:5000/hello/World

8 Usa el modo de depuración de Flask

En desarrollo, debug=True habilita la recarga en vivo del código y mejores rastreos de errores, lo cual es muy útil al iterar.

Si no lo habilitaste antes, cambia las últimas líneas en app.py:

if __name__ == "__main__":
    app.run(host="127.0.0.1", port=5000, debug=True)

Nota: no uses el servidor integrado en producción. Para producción, ejecuta detrás de un servidor WSGI real (por ejemplo, Gunicorn) detrás de un proxy inverso (por ejemplo, Nginx).

9 Estructura de proyecto (opcional)

A medida que los proyectos crecen, un diseño ordenado ayuda:

hello-flask/
├─ app/
│  ├─ __init__.py
│  └─ routes.py
├─ requirements.txt
└─ run.py

Ejemplo de app/__init__.py:

from flask import Flask

def create_app():
    app = Flask(__name__)
    from .routes import bp
    app.register_blueprint(bp, url_prefix="/")
    return app

Ejemplo de app/routes.py:

from flask import Blueprint

bp = Blueprint("main", __name__)

@bp.get("/")
def hello():
    return "Hello from Flask!"

@bp.get("/hello/")
def hello_name(name: str):
    return f"Hello, {name}!"

Ejemplo de run.py:

from app import create_app

app = create_app()

if __name__ == "__main__":
    app.run(host="127.0.0.1", port=5000, debug=True)

Congela las dependencias con pip freeze > requirements.txt.

10 Próximos pasos y trampas comunes

Plantillas: usa render_template("index.html", name=name) con archivos Jinja2.
Archivos estáticos: sirve CSS/JS desde una carpeta static/.
Configuración: mantén los secretos fuera del código; usa variables de entorno.
Producción: ejecuta detrás de Gunicorn o uWSGI, detrás de un proxy inverso.
El servidor de depuración no se recargará en Windows con git-bash + virtualenv; usa el Símbolo del sistema o PowerShell para activar el venv allí.

Ahora tienes una aplicación Flask funcional. A partir de aquí, puedes agregar plantillas, formularios y una estructura de proyecto real sin cambiar la idea central.

Progreso del Tutorial