Instalar Python 3.14 en Windows, macOS y Linux

Para seguir este curso en tu propia computadora necesitas Python 3.14 o posterior. Un Mac puede tener a la vez el python3 más antiguo de Apple y tu nuevo 3.14, y el terminal ejecuta el que encuentra primero. Instalar lleva unos minutos; donde la gente se atasca es en asegurarse de que el terminal ejecuta el Python que acaba de instalar, así que esta lección dedica tanto tiempo a comprobar como a instalar.

Instalar 3.14 junto al Python que ya tienes

Cualquier sistema puede tener varios Python, uno al lado del otro. Cuando el sistema operativo trae uno, el Python del sistemaEl Python que vino con el sistema operativo, como el python3 de una distribución de Linux o el de Apple en /usr/bin. Las herramientas del propio sistema dependen de él, así que las demás versiones van a su lado, nunca en su lugar., se queda, así que la tarea es añadir 3.14 a su lado, desde la fuente que le vaya bien a tu sistema.

Primero, comprueba lo que ya tienes

Abre un terminal: Terminal en macOS, el terminal de tu distribución en Linux, Windows Terminal o PowerShell en Windows. Después, pregúntale a Python su versión:

• macOS y Linux: python3 --version
• Windows: py --version (o python --version)

Si imprime Python 3.14 seguido de un número de corrección, o algo más nuevo, salta a PATH decide qué Python ejecuta una orden. Si imprime una versión más antigua, o no encuentra la orden, instala 3.14 como se describe para tu sistema.

Windows

La documentación de Python para Windows recomienda el Python install manager, que consigues en python.org o en Microsoft Store. Te da la orden py (y python), que instala y ejecuta versiones de Python una al lado de la otra:

• py install 3.14 instala el último Python 3.14.
• py list muestra las versiones instaladas.
• py script.py ejecuta un script con la versión predeterminada.

Cuando el install manager instala su primer runtime, es probable que se ofrezca a añadir una carpeta a tu PATH. Puedes saltártelo si usas py; acéptalo si también quieres órdenes con la versión en el nombre, como python3.14. Abre una ventana de terminal nueva después de instalar, para que reconozca las órdenes nuevas. Si al escribir python se abre Microsoft Store o dice que no encuentra la orden, usa py, o abre Manage app execution aliases en la Configuración de Windows y comprueba que los alias de Python (default) están activados; si ya lo están, desactívalos y vuelve a activarlos.

macOS

Puede que tu Mac ya tenga una orden python3, pero a menudo es un Python más antiguo que vino con las herramientas para desarrolladores de Apple. Instala 3.14 a su lado; no intentes quitar el antiguo.

• Instalador de python.org: descarga el instalador de macOS de Python 3.14 desde python.org/downloads y ejecútalo. Añade las órdenes python3 y python3.14.
• Un gestor de paquetes, si ya usas uno, por ejemplo Homebrew: brew install python@3.14.

Después, abre una ventana de Terminal nueva y vuelve a comprobar la versión.

Linux

La mayoría de las distribuciones de Linux incluyen un Python 3 del que dependen las herramientas del propio sistema. Nunca lo quites ni lo sustituyas: partes del sistema pueden dejar de funcionar. En su lugar, instala la versión que necesitas a su lado:

• desde los paquetes de tu distribución, si ofrece Python 3.14;
• con un gestor de versiones (abajo), que instala cualquier versión exacta en tu carpeta personal;
• o compilándolo desde el código fuente, como describe la documentación de Python.

Gestores de versiones (cualquier sistema)

Un gestor de versionesUna herramienta como uv, mise o pyenv que instala versiones exactas de Python una al lado de la otra, normalmente en tu carpeta personal, y deja que cada proyecto elija una. instala versiones exactas, mantiene varias a la vez y deja que cada proyecto elija una. Tres muy usados:

• uv (una lección posterior lo trata): uv python install 3.14
• mise: mise install python@3.14.8. Los ejemplos de este curso se ejecutan con mise exec python@3.14.8 -- python3.
• pyenv (macOS y Linux): pyenv install 3.14.8

Each makes its Pythons reachable through PATHPATH: The environment variable that lists the folders a shell searches, in order, for a command you type. A command whose folder is not on PATH answers "command not found" until the folder is added or the full path is typed., the list of folders the next section is about: uv puts a versioned command such as python3.14 there, and pyenv puts a folder of its own small programs, called shims, at the front of the list.

Qué camino elegir

Lee la tabla desde tu situación: un único Python para este curso en una computadora con Windows o macOS es la compilación de python.org, y dos proyectos que necesitan dos versiones exactas son justo para lo que sirven los gestores de versiones.

PATH decide qué Python ejecuta una orden

Tu terminal encuentra una orden buscando en las carpetas que enumera la variable de entorno PATH, por orden, y ejecuta la primera coincidencia. Recorre tres búsquedas en un mismo PATH en un Mac, donde el instalador de python.org ha puesto su python3 en /usr/local/bin y el antiguo de Apple está en /usr/bin:

La búsqueda se detuvo cada vez en el primer python3, y solo el orden de las carpetas decidió cuál era. Eso explica los dos problemas habituales:

• Command not found: ninguna carpeta de PATH contiene python3 (o py). Abre un terminal nuevo después de instalar; si la orden sigue sin encontrarse, la carpeta de Python todavía no está en PATH, y tienes que añadirla en la configuración de tu shell o de tu sistema.
• Se ejecuta la versión equivocada: un Python más antiguo está en una carpeta que va antes en PATH.

Pregúntale al intérprete dónde vive con python3 -c "import sys; print(sys.executable)". En macOS y Linux, which -a python3 enumera cada python3 de tu PATH en el orden en que los prueba el terminal; en Windows, where python hace lo mismo.

Cuando la primera coincidencia es la equivocada, tienes dos salidas. Escribe una orden que solo tenga la instalación nueva, como python3.14, que dan tanto el instalador de python.org para macOS como uv, o mueve la carpeta de la instalación nueva antes en PATH y abre un terminal nuevo. Nunca lo arregles borrando el Python más antiguo.

Comprueba la versión en el código con tuplas, no con texto

Cuando ya se ejecute el Python correcto, guarda este programa como check_version.py y ejecútalo con python3 check_version.py (o py check_version.py):

import sys

minimum = (3, 14)
installed = sys.version.split()[0]

if sys.version_info >= minimum:
    print("OK: Python", installed, "is new enough for this track.")
else:
    print("This track needs Python 3.14 or newer, but this is Python", installed)

OK: Python 3.14.8 is new enough for this track.

OK: Python 3.14.2 is new enough for this track.

sys.version_info es la versión del intérprete en ejecución como una tupla de números, así que compararla con (3, 14) funciona para cualquier versión de corrección de 3.14 y para cualquier versión posterior. En un intérprete más antiguo, como Python 3.12, el mismo archivo imprime el segundo mensaje.

La tupla importa. Una versión escrita como texto se compara carácter a carácter, y entonces 3.9 parece más nueva que 3.14. Recorre tres versiones comparadas de las dos formas:

versions = ["3.9", "3.14", "3.12"]
for text in versions:
    as_text = text >= "3.14"
    major, minor = text.split(".")
    nums = (int(major), int(minor))
    as_nums = nums >= (3, 14)
    print(text, as_text, as_nums)

3.9 True False
3.14 True True
3.12 False False

La comparación de texto dejó pasar 3.9 y acertó con 3.12 solo por suerte; las tuplas acertaron siempre. Pulsa Editar, añade "3.2" a la lista y ejecútalo: como texto, Python 3.2 también cuenta como lo bastante nuevo para este curso.

Practica: comprobar una versión en el código

El ejercicio convierte check_version.py en una función que puedes probar con versiones inventadas, incluida la 3.9 que la comparación de texto calcula mal. Sus pruebas de ejemplo se ejecutan en tu navegador, y tienes una primera pista si la necesitas:

def check_version(version_info, minimum=(3, 14)):
    """Return "ok" when version_info is minimum or newer, otherwise a message saying which Python to install."""
    return "ok"

from version_check import check_version


def test_new_enough():
    """accepts 3.14 and every later version"""
    assert check_version((3, 14, 8)) == "ok"
    assert check_version((3, 15, 0)) == "ok"
    assert check_version((4, 0, 0)) == "ok"


def test_exactly_the_minimum():
    """accepts a version equal to the minimum"""
    assert check_version((3, 14, 0), minimum=(3, 14, 0)) == "ok"


def test_too_old():
    """names the version found and the one to install"""
    assert check_version((3, 12, 4)) == "Python 3.12.4 is too old: install Python 3.14 or newer"


def test_numbers_not_text():
    """compares numbers, so 3.9 is older than 3.14"""
    assert check_version((3, 9, 1)) == "Python 3.9.1 is too old: install Python 3.14 or newer"


def test_other_minimum():
    """uses the minimum it is given"""
    assert check_version((3, 12, 4), minimum=(3, 12)) == "ok"
    assert check_version((3, 11, 9), minimum=(3, 12)) == "Python 3.11.9 is too old: install Python 3.12 or newer"

Después repasa las preguntas de esta lección sobre la instalación, PATH y las comprobaciones de versión. La más floja de las tres sale primero, y cada opción se explica sola:

Para recordar

• En Windows, usa el Python install manager y la orden py; en macOS, el instalador de python.org o un gestor de paquetes; en Linux, instala 3.14 junto al Python del sistema y nunca lo quites.
• Después de instalar, abre un terminal nuevo y comprueba la versión con python3 --version o py --version.
• PATH decide qué Python ejecuta una orden: sys.executable y which -a python3 (o where python) muestran lo que obtienes de verdad.
• Compara sys.version_info con una tupla, como (3, 14), para comprobar una versión mínima en el código.