Este documento te guiará a través del proceso de instalación de Python 3.14 y Django en Windows. También proporciona instrucciones para configurar un entorno virtual, lo que facilita trabajar en proyectos de Python. Este es un manual para principiantes para usuarios que trabajan en proyectos de Django y no refleja cómo instalar Django cuando se están desarrollando cambios para Django mismo.
Los pasos de este guía han sido probados con Windows 10. En otras versiones, los pasos serían similares. Debes estar familiarizado con el uso del prompt de comandos de Windows.
Django es un framework web de Python, por lo que requiere que se instale Python en tu máquina. En el momento de escribir esto, la versión más reciente de Python es 3.14.
Para instalar Python en tu máquina ve a https://www.python.org/downloads/. El sitio web debería ofrecerte un botón de descarga para la última versión de Python. Descarga el instalador ejecutable y ejecútalo. Verifica las casillas junto a «Instalar lanzador para todos los usuarios (recomendado)» luego haz clic en «Instalar ahora».
Después de la instalación, abre el prompt de comandos y verifica que la versión de Python coincida con la versión que instalaste ejecutando:
...\> py --version
py no está reconocido ni encontrado
Dependiendo de cómo hayas instalado Python (como a través del Microsoft Store), py puede no estar disponible en el prompt de comandos.
You deberán utilizar python en lugar de py cuando ingresen comandos.
Ver también
Para obtener más detalles, consulte la documentación Using Python on Windows.
pip¶pip es un administrador de paquetes para Python y se incluye por defecto con el instalador de Python. Ayuda a instalar y desinstalar paquetes de Python (como Django!). Para el resto de la instalación, utilizaremos pip para instalar paquetes de Python desde la línea de comandos.
La mejor práctica es proporcionar un entorno dedicado para cada proyecto de Django que crees. Hay muchas opciones para gestionar entornos y paquetes dentro del ecosistema Python, algunas de las cuales se recomiendan en la documentación Python. Python mismo viene con venv para gestionar entornos que utilizaremos para esta guía.
Para crear un entorno virtual para tu proyecto, abre una nueva ventana de comandos, navega hasta la carpeta donde deseas crear tu proyecto y luego ingresa lo siguiente:
...\> py -m venv project-name
Esto creará una carpeta llamada “project-name” si no existe ya y configurará el entorno virtual. Para activar el entorno, ejecuta:
...\> project-name\Scripts\activate.bat
El entorno virtual se habrá activado y verás «(project-name)» junto a la ventana de comandos para designar que. Cada vez que inicies una nueva ventana de comandos, deberás activar el entorno nuevamente.
Django se puede instalar fácilmente utilizando pip dentro de tu entorno virtual.
En la línea de comandos, asegúrate de que tu entorno virtual esté activo y ejecuta el siguiente comando:
...\> py -m pip install Django
Esto descargará e instalará la última versión de Django.
Después de completada la instalación, puedes verificar tu instalación de Django ejecutando django-admin --version en la línea de comandos.
Consulte Haz funcionar tu base de datos para obtener información sobre la instalación de bases de datos con Django.
Una característica de calidad de vida agrega una salida coloreada (en lugar de monocroma) al terminal. En terminales modernos esto debería funcionar tanto para CMD como PowerShell. Si por alguna razón esto necesita ser deshabilitado, establece la variable de entorno DJANGO_COLORS a nocolor.
En versiones antiguas de Windows o terminales legados, se debe instalar colorama 0.4.6+ para habilitar el coloreado de sintaxis:
...\> py -m pip install "colorama >= 0.4.6"
Consulte Coloración sintáctica para obtener más información sobre las configuraciones de color.
Si django-admin solo muestra el texto de ayuda sin importar los argumentos que se le pasen, probablemente hay un problema con la asociación del archivo en Windows. Verifica si hay más de una variable de entorno configurada para ejecutar scripts de Python en PATH. Esto suele ocurrir cuando se instalan varias versiones de Python.
Si estás conectado a Internet detrás de un proxy, es posible que tengas problemas al ejecutar el comando py -m pip install Django. Configura las variables de entorno para la configuración del proxy en la ventana de comandos de la siguiente manera:
...\> set http_proxy=http://username:password@proxyserver:proxyport
...\> set https_proxy=https://username:password@proxyserver:proxyport
En general, Django asume que se utiliza el codificado UTF-8 para la entrada y salida. Esto puede causar problemas si tu sistema está configurado para utilizar un código de caracteres diferente. Las versiones recientes de Python permiten establecer la variable de entorno PYTHONUTF8 para forzar el uso del codificado UTF-8. Windows 10 también proporciona una configuración sistemática al verificar Utilizar Unicode UTF-8 para el soporte de lenguaje mundial en en las configuraciones del sistema.
may 31, 2026