¿Cómo configurar tu entorno de Python para automatización?

Configurar tu entorno de Python correctamente es el primer paso para automatizar tareas sin errores ni conflictos entre proyectos.

Un entorno bien configurado separa las bibliotecas de cada proyecto. Así evitas que una actualización dañe otro script que ya funciona.

Instalar Python en tu computadora

Python es el intérprete que ejecuta tu código. Sin él, ningún script funciona.

Descarga la versión más reciente desde python.org. En 2024, la versión estable es la 3.12.

Pasos para Windows:

1. Descarga el instalador .exe desde python.org.
2. Marca la casilla "Add Python to PATH" antes de hacer clic en "Install Now".
3. Abre la terminal (cmd o PowerShell) y escribe:

python --version

Debes ver algo como:

Python 3.12.3

Si ves ese resultado, la instalación fue exitosa.

Pasos para macOS:

En macOS ya viene una versión antigua de Python. Instala la versión actual con Homebrew:

brew install python

Después verifica con python3 --version.

Pasos para Linux (Ubuntu/Debian):

sudo apt update
sudo apt install python3 python3-pip

Verifica con python3 --version.

Elegir un editor de código

El editor de código es donde escribes y ejecutas tus scripts.

La opción más recomendada para automatización es Visual Studio Code (VS Code). Es gratuito, ligero y tiene extensiones para Python.

Instala la extensión oficial de Python desde el marketplace de VS Code. Esa extensión activa el autocompletado, el resaltado de errores y el depurador.

Otra opción válida es PyCharm Community Edition, también gratuito. Es más pesado, pero tiene herramientas avanzadas integradas.

¿Qué es un entorno virtual y por qué lo necesitas?

Un entorno virtual es una carpeta aislada que contiene su propia versión de Python y sus propias bibliotecas, separadas del sistema.

Imagina que tienes dos proyectos: uno para Liverpool que usa openpyxl 3.0 y otro para FEMSA que necesita openpyxl 3.1. Sin entornos virtuales, instalar una versión rompe la otra. Con entornos virtuales, cada proyecto vive en su propio espacio.

Crear un entorno virtual paso a paso

Primero, crea una carpeta para tu proyecto:

mkdir automatizacion_femsa
cd automatizacion_femsa

Dentro de esa carpeta, crea el entorno virtual:

python -m venv venv

Esto genera una carpeta llamada venv con todo lo necesario.

Activa el entorno virtual:

En Windows:

venv\Scripts\activate

En macOS/Linux:

source venv/bin/activate

Cuando el entorno está activo, verás su nombre entre paréntesis en la terminal:

(venv) C:\automatizacion_femsa>

Para desactivarlo cuando termines:

deactivate

Regla práctica: Activa siempre el entorno virtual antes de instalar bibliotecas o ejecutar scripts.

Instalar las bibliotecas esenciales para automatización

pip es el gestor de paquetes de Python. Con él instalas cualquier biblioteca desde el repositorio oficial PyPI.

Con el entorno virtual activo, instala las bibliotecas más usadas en automatización:

pip install requests openpyxl pandas selenium schedule

¿Para qué sirve cada una?

Para proyectos de Mercado Libre, por ejemplo, usarás requests para consumir su API y pandas para procesar el catálogo de productos.

Guardar las dependencias del proyecto:

Ejecuta este comando para generar un archivo con todas las bibliotecas instaladas:

pip freeze > requirements.txt

Cuando alguien más necesite replicar tu entorno, solo ejecuta:

pip install -r requirements.txt

Esto garantiza que todos trabajen con las mismas versiones.

Estructura básica de un script de automatización

Un script de automatización bien organizado tiene cuatro secciones: importaciones, configuración, lógica principal y punto de entrada.

Aquí está la plantilla base que usarás en todos tus proyectos:

# 1. Importaciones
import os
import pandas as pd
from openpyxl import load_workbook

# 2. Configuración
ARCHIVO_ENTRADA = "ventas_bimbo.xlsx"
ARCHIVO_SALIDA = "reporte_procesado.xlsx"
SALARIO_BASE = 18500

# 3. Función principal
def procesar_ventas():
    df = pd.read_excel(ARCHIVO_ENTRADA)
    total = df["monto"].sum()
    promedio = df["monto"].mean()
    print(f"Total de ventas: ${total:,.0f}")
    print(f"Promedio por venta: ${promedio:,.0f}")
    df.to_excel(ARCHIVO_SALIDA, index=False)
    print("Reporte guardado correctamente.")

# 4. Punto de entrada
if __name__ == "__main__":
    procesar_ventas()

Resultado esperado en consola:

Total de ventas: $1,240,500
Promedio por venta: $18,500
Reporte guardado correctamente.

Nota el uso de f"${total:,.0f}" para formatear los números con coma de miles y sin decimales. Así los importes se ven como $1,240,500 y no como $1,240,500.

¿Por qué usar if __name__ == "__main__"?

Esta línea garantiza que el script solo se ejecute directamente, no cuando otro archivo lo importe. Es una buena práctica estándar en Python.

Organizar tus carpetas de proyecto

Una estructura de carpetas clara evita confusión cuando el proyecto crece.

Esta es la organización recomendada:

automatizacion_femsa/
├── venv/                  # Entorno virtual (no subir a Git)
├── datos/                 # Archivos de entrada (Excel, CSV)
├── reportes/              # Archivos de salida generados
├── scripts/               # Tus scripts de Python
│   └── procesar_ventas.py
├── requirements.txt       # Lista de dependencias
└── README.md              # Descripción del proyecto

Nunca subas la carpeta venv a Git. Agrega venv/ a tu archivo .gitignore.

Verificar que todo funciona

Antes de empezar a automatizar en serio, ejecuta esta verificación rápida.

Crea un archivo llamado verificar.py con este contenido:

import sys
import requests
import pandas as pd
import openpyxl

print(f"Python: {sys.version}")
print(f"requests: {requests.__version__}")
print(f"pandas: {pd.__version__}")
print(f"openpyxl: {openpyxl.__version__}")
print("Todo listo para automatizar.")

Ejecútalo con:

python verificar.py

Si todas las versiones aparecen sin errores, tu entorno está listo.

Errores comunes al configurar el entorno

Error 1: No activar el entorno virtual antes de instalar.

Si instalas con pip install sin activar el entorno, las bibliotecas se instalan de forma global. Eso contamina el sistema y genera conflictos. Siempre activa venv primero.

Error 2: Olvidar la casilla "Add Python to PATH" en Windows.

Sin esa opción, la terminal no reconoce el comando python. El síntoma es el mensaje 'python' is not recognized as an internal or external command. Solución: reinstala Python y marca esa casilla.

Error 3: Usar espacios o acentos en nombres de carpetas.

Nombres como mi proyecto o automatización causan errores en algunos sistemas. Usa solo letras, números y guiones bajos: mi_proyecto, automatizacion_bimbo.

Error 4: No guardar el archivo requirements.txt.

Si compartes tu proyecto con un colega en Liverpool o FEMSA sin ese archivo, no podrán replicar tu entorno. Genera ese archivo siempre antes de compartir.

Resumen de comandos clave

Con estos pasos, tienes todo lo necesario para empezar a escribir scripts de automatización reales en cualquier proyecto.