2. Instalación y configuración del entorno

📦 2.1 Instalación de FastAPI

Requisitos previos

Antes de instalar FastAPI necesitas:

Requisito	Versión mínima
Python	3.7 o superior
pip	Última versión

Verificar Python instalado

# Verificar versión de Python
python --version
# Python 3.11.0

# Verificar pip
pip --version
# pip 23.0 from ...

Instalar FastAPI

# Instalación básica
pip install fastapi

# Instalación con todas las dependencias opcionales
pip install "fastapi[all]"

Verificar instalación

# Verificar que FastAPI está instalado
pip show fastapi

# Salida esperada:
# Name: fastapi
# Version: 0.109.0
# ...

🦄 2.2 Instalación de Uvicorn (servidor ASGI)

Qué es Uvicorn

Uvicorn es un servidor ASGI (Asynchronous Server Gateway Interface) de alto rendimiento. Es necesario para ejecutar aplicaciones FastAPI.

Característica	Descripción
ASGI	Protocolo asíncrono para Python
Alto rendimiento	Basado en uvloop y httptools
Recarga automática	Detecta cambios en el código

Instalar Uvicorn

# Instalación básica
pip install uvicorn

# Instalación con extras de rendimiento
pip install "uvicorn[standard]"

Verificar instalación

# Verificar Uvicorn
uvicorn --version
# Running uvicorn 0.27.0 with CPython 3.11.0 on Windows

🆕 2.3 Crear el primer proyecto FastAPI

Crear carpeta del proyecto

# Crear carpeta del proyecto
mkdir mi_api
cd mi_api

# Crear entorno virtual (recomendado)
python -m venv venv

# Activar entorno virtual
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate

# Instalar dependencias
pip install fastapi uvicorn

Crear archivo principal

# Crear archivo main.py
# Windows:
type nul > main.py
# Linux/Mac:
touch main.py

Escribir la primera API

from fastapi import FastAPI

# Crear instancia de la aplicación
app = FastAPI()

# Definir ruta raíz
@app.get("/")
def inicio():
  return {"mensaje": "¡Hola, FastAPI!"}

📁 2.4 Estructura mínima de un proyecto

Estructura básica

mi_api/
├── venv/              # Entorno virtual
├── main.py            # Archivo principal
└── requirements.txt   # Dependencias

Crear requirements.txt

# Generar archivo de dependencias
pip freeze > requirements.txt

fastapi==0.109.0
uvicorn==0.27.0

Estructura para proyectos más grandes

mi_api/
├── app/
│   ├── __init__.py
│   ├── main.py        # Punto de entrada
│   ├── routers/       # Rutas organizadas
│   ├── models/        # Modelos Pydantic
│   └── services/      # Lógica de negocio
├── venv/
├── requirements.txt
└── README.md

▶️ 2.5 Ejecutar el servidor de desarrollo

Comando básico

# Ejecutar servidor
uvicorn main:app

# Salida:
# INFO:     Started server process [12345]
# INFO:     Waiting for application startup.
# INFO:     Application startup complete.
# INFO:     Uvicorn running on http://127.0.0.1:8000

Parámetros del comando

Parámetro	Descripción
`main`	Nombre del archivo (sin .py)
`app`	Nombre de la instancia FastAPI
`--host`	Dirección IP (default: 127.0.0.1)
`--port`	Puerto (default: 8000)

Ejemplo con parámetros

# Ejecutar en puerto específico
uvicorn main:app --port 3000

# Ejecutar accesible desde otras máquinas
uvicorn main:app --host 0.0.0.0 --port 8000

Probar la API

# Desde el navegador
http://localhost:8000

# Respuesta JSON:
{"mensaje": "¡Hola, FastAPI!"}

# Documentación automática
http://localhost:8000/docs

🔄 2.6 Uso de recarga automática (reload)

Qué es la recarga automática

La opción --reload hace que Uvicorn reinicie automáticamente cuando detecta cambios en el código. Es ideal para desarrollo.

Activar recarga automática

# Ejecutar con recarga automática
uvicorn main:app --reload

# Salida:
# INFO:     Will watch for changes in these directories: ['/ruta/mi_api']
# INFO:     Uvicorn running on http://127.0.0.1:8000
# INFO:     Started reloader process [12345]

Comando completo para desarrollo

# Comando recomendado para desarrollo
uvicorn main:app --reload --host 0.0.0.0 --port 8000

Ejemplo: Probar recarga automática

# 1. Ejecutar servidor con reload
uvicorn main:app --reload

# 2. Modificar main.py (cambiar el mensaje)
@app.get("/")
def inicio():
  return {"mensaje": "¡Mensaje actualizado!"}

# 3. Guardar el archivo
# El servidor se reinicia automáticamente

# 4. Refrescar navegador
# Verás el nuevo mensaje sin reiniciar manualmente

📝 Resumen

🐝