02. Configuración Inicial

Gestionando librerías con pip

Gestionar librerías con pip

Ahora que tenemos nuestra carpeta y los archivos iniciales listos (main.py y requirements.txt), comenzaremos a instalar las librerías que necesitaremos para trabajar con FastAPI.

Esta será la primera vez que usemos pip, el administrador de paquetes de Python.


Paso 5. Instalar dependencias con pip

pip es la herramienta que permite descargar e instalar librerías creadas por otros desarrolladores (como FastAPI, Uvicorn, Pydantic, etc.).

Estas librerías se almacenan dentro del entorno virtual (.venv) para mantener tu proyecto aislado y ordenado.

En tu terminal (con el entorno virtual activo), escribe lo siguiente.

bash
python -m pip install fastapi uvicorn

Analizando el comando, veremos que:

  • python -m pip asegura que se use el pip del entorno virtual, no el global del sistema.
  • install fastapi uvicorn descarga e instala las dos librerías que usaremos para comenzar:
    • FastAPI: el framework para crear nuestra API.
    • Uvicorn: el servidor que ejecutará la aplicación.

Perfecto. Entonces, podemos ejecutar a continuación otro comando para verificar que se instaló correctamente.

bash
python -m pip list

Verás que se instalaron dependencias y sub-dependencias. Principalmente nota que tenemos uvicorn y fastapi disponibles.


Probar FastAPI y Uvicorn

Con las dependencias ya instaladas, vamos a probar nuestro primer archivo main.py.

Ejecuta el siguiente comando en tu terminal:

bash
uvicorn main:app --reload

Esto significa que:

  • uvicorn ejecuta el servidor.
  • main:app indica que dentro del archivo main.py existe una variable llamada app (nuestro objeto FastAPI).
  • --reload reinicia el servidor automáticamente cada vez que guardas cambios.

Abre tu navegador y visita http://127.0.0.1:8000

Obtendrás algo así:

json
{
  "message": "Hello World"
}

Perfecto. Significa que funciona bien.

Ahora, abre este enlace.

http://localhost:8000/docs

Esto significa que FastAPI y uvicorn están corriendo juntos.

En este momento, ya tienes:

  • FastAPI y Uvicorn instalados correctamente.
  • El servidor funcionando y escuchando en el puerto 8000.
  • Tu entorno virtual activo y aislado.

Perfecto. Avancemos al siguiente contenido donde haremos registro de las dependencias que tenemos en requirements.txt.