correo/INSTALACION.md

2.7 KiB

Guía de Instalación - Cliente de Correo

Problema: Error de Tkinter en macOS

Si recibes el error "macOS 26 (2602) or later required, have instead 16 (1602) !", significa que tu versión de Python está usando una versión antigua de Tcl/Tk.

Solución: Instalar Python desde python.org

Opción 1: Instalar Python 3.11 o superior (RECOMENDADO)

  1. Descargar Python:

  2. Instalar:

    • Abre el archivo .pkg descargado
    • Sigue el asistente de instalación
    • Acepta todas las opciones por defecto
  3. Verificar instalación:

    python3 --version
    

    Deberías ver algo como: Python 3.11.x o superior

  4. Ejecutar el cliente:

    python3 cliente_correo.py
    

Opción 2: Usar Homebrew (Alternativa)

Si tienes Homebrew instalado:

# Instalar Python con Homebrew
brew install python@3.11

# Verificar
python3 --version

# Ejecutar el cliente
python3 cliente_correo.py

Opción 3: Usar pyenv (Para desarrolladores)

# Instalar pyenv
brew install pyenv

# Instalar Python 3.11
pyenv install 3.11.7

# Establecer como versión local
pyenv local 3.11.7

# Ejecutar el cliente
python cliente_correo.py

Verificar que Tkinter funciona

Después de instalar Python actualizado, verifica que Tkinter funcione:

python3 -m tkinter

Esto debería abrir una ventana de prueba de Tkinter. Si ves la ventana, todo está bien.

Notas Importantes

  • NO uses el Python que viene con macOS (/usr/bin/python), ya que suele estar desactualizado
  • Después de instalar Python desde python.org, usa siempre python3 en lugar de python
  • Si ya tienes múltiples versiones de Python, puedes verificar cuál estás usando con:
    which python3
    
    Debería mostrar algo como /Library/Frameworks/Python.framework/...

Si aún tienes problemas

Verificar la versión de Tcl/Tk:

python3 -c "import tkinter; print(tkinter.TkVersion)"

Debería mostrar 8.6 o superior.

Reinstalar Python:

Si instalaste Python pero aún tienes problemas:

  1. Desinstala Python antiguo
  2. Descarga la última versión de python.org
  3. Instala de nuevo
  4. Abre una nueva terminal (importante)
  5. Intenta ejecutar el cliente de nuevo

Alternativas sin instalar Python

Si no puedes o no quieres instalar Python actualizado, puedo crear versiones alternativas:

  1. Cliente web: Interfaz HTML que funciona en el navegador
  2. Cliente CLI: Interfaz de línea de comandos sin GUI
  3. Cliente con PyQt5: Requiere pip install PyQt5

Házmelo saber si necesitas alguna de estas alternativas.