Para instalar Django, primero asegúrate de tener un entorno virtual configurado. Luego, usa el comando pip install django para instalarlo. Si no especificas la versión, pip instalará la última disponible compatible con tu versión de Python.
Al ejecutar este comando, verás que Django se instala junto con sus dependencias, necesarias para su funcionamiento. Esto es porque Django reutiliza librerías existentes para ciertas funcionalidades.
¿Qué es el comando django-admin y cómo se usa?
Una vez instalado Django, obtienes acceso al comando django-admin, que es una herramienta de línea de comandos para administrar tareas relacionadas con Django. Para ver todos los subcomandos disponibles, puedes ejecutar django-admin help.
¿Cómo crear un proyecto con django-admin?
El subcomando que más nos interesa es startproject, que se usa para crear un nuevo proyecto Django. Para hacerlo, ejecuta:
django-admin startproject nombre_del_proyecto
Asegúrate de no usar guiones en el nombre del proyecto, ya que Django interpretará eso como un intento de resta en Python. Usa guiones bajos en su lugar.
¿Qué archivos se crean con startproject?
El comando startproject crea una nueva carpeta con el nombre del proyecto. Dentro de esta carpeta, encontrarás:
Una subcarpeta con configuraciones del proyecto.
Un archivo manage.py, que sirve para ejecutar comandos específicos del proyecto.
El archivo manage.py se utiliza para comandos que afectan solo al proyecto actual. Para ver los comandos disponibles, ejecuta:
python manage.py help
¿Cómo ejecutar el servidor de desarrollo?
Para ver tu aplicación en funcionamiento, usa el comando runserver:
python manage.py runserver
Este comando inicia un servidor de desarrollo y te indica la URL y el puerto donde tu aplicación está corriendo. Puedes abrir esta URL en tu navegador para verificar que todo está configurado correctamente.
Como complemento me gustaría agregar que en vez de usar:
django-admin startproject name
usar:
django-admin startproject name .
el punto al final hace que el proyecto se cree a la misma altura de la raíz, y que no se duplique la carpeta, como ven al profe se le crea la carpeta principal con el nombre que le dio y dentro va otra carpeta con el mismo nombre pero que ya tiene los archivos del proyecto, con el "." se elimina este paso. me a ahorra muchos dolores de cabeza con el enrutamiento y la importación de modulos
Este es un buen tip, además pueden ver todos los parámetros que acepta el comando ejecutando --help para ver la guía de ayuda.
La forma en la que lo hace el profesor es la correcta ya que la segunda carpeta contiene las configuraciones globales del proyecto.
Dentro del manage.py tienes asignada una variable que se llama DJANGO_SETTINGS_MODULE y es la que define la configuracion de tu proyecto por lo cual en este caso tendrian my_fistr_project.settings que hace referencia a esa segunda carpeta que mencionan.
Si en determinado caso generas una segunda aplicacion o tienes multiples configuracion en tu ruta "raiz" solo existiria un manage.py y se ejecutaria la configuracion del proyecto que tengas en la variable DJANGO_SETTINGS_MODULE, es por eso que el ordenamiento que ves es el correcto.
To run the Django development server on a different port, you can specify the port number at the end of the runserver command. For example, if you want to run the server on port 7000, you would use:
python manage.py runserver 7000
Correcto!
Hay muchas otras opciones que puede revisar ejecutando
./manage.py runserver --help
cool!
Para evitar entrar en la carpeta my_first_project y usar los comandos de manage.py desde allí, puedes hacer lo siguiente:
Ejecuta el siguiente comando:
django-admin startproject my_first_project .
El punto al final del comando asegura que el proyecto se cree en el directorio actual, en lugar de crear una nueva carpeta my_first_project dentro del directorio actual. Esto mantiene todos los archivos del proyecto en la raíz del directorio actual.
Esta es la estructura base correcta que debe tene un proyecto django:
myproject/
├── manage.py
├── myproject/
│ ├── __init__.py
│ ├── asgi.py
│ ├── settings.py
│ ├── urls.py
│ └── wsgi.py
├── myapp/
│ ├── __init__.py
│ ├── admin.py
│ ├── apps.py
│ ├── migrations/
│ │ └── ...
│ ├── models.py
│ ├── tests.py
│ └── views.py
├── static/
│ └── ...
├── templates/
│ └── ...
├── .gitignore
└── requirements.txt
Genial, corriendo el servidor de Django, feliz por aprender este framework nuevo y poder encontrar mejores oportunidades laborales.
Para DETENER el servidor de manera segura, basta presionar las teclas CONTROL + C
Step by Step until run Django on windows 11 by Vs Code Terminal
pip install Django
django-admin --help
django-admin startproject my_first_proyect
cd my_first_proyect ---> ls ---> manage.py + my_first_proyect
python manage.py --help
# run Django
python manage.py runserver
Soy tan feliz cuando veo el back-end corriendo:
cooooooooool! 🤯
Para aquellos que tengan la terminal inteligente fish y no los deje activar el entorno virtual desde la terminal, lo que tienen que hacer es usar el comando source pero con activate.fish, por ejemplo:
source venv/bin/activate.fish
Suelo utilizar: py manage.py config .
esto crea el proyecto con la carpeta config pero deja el manage.py afuera.
usenlo mucho para que no cree carpeta despues.
📚 Nombre de la clase
Cómo instalar Django
🎯 Idea principal
Para comenzar a desarrollar con Django es necesario instalar el framework dentro de un entorno virtual de Python. Esto se hace utilizando un gestor de paquetes que permite descargar e instalar la librería desde el repositorio oficial. Una vez instalado, se puede verificar la versión y comenzar a crear proyectos web.
⚡ Síntesis en 10 segundos
Django se instala como una librería de Python.
La instalación se realiza dentro de un entorno virtual.
Se utiliza un gestor de paquetes para instalarlo.
Después de instalarlo se puede verificar la versión.
Con Django instalado ya es posible crear proyectos web.
🔑 Puntos clave
Instalación mediante gestor de paquetes
Django se descarga desde el repositorio de paquetes de Python utilizando el gestor de paquetes.
Instalación dentro del entorno virtual
Siempre se debe instalar Django dentro del entorno virtual del proyecto.
Verificación de instalación
Después de instalarlo se puede comprobar que Django está disponible consultando su versión.
Dependencias del proyecto
Django se convierte en una dependencia del proyecto y será necesario para ejecutar la aplicación.
Preparación para el desarrollo
Una vez instalado Django se puede comenzar a crear el primer proyecto.
🧠 Conceptos importantes
Gestor de paquetes
Herramienta que permite descargar, instalar y administrar librerías de Python.
Repositorio de paquetes
Base de datos de librerías donde los desarrolladores publican paquetes reutilizables.
Dependencias
Software externo que un proyecto necesita para funcionar.
Versión del framework
Permite saber qué versión de Django está instalada y asegurar compatibilidad.
🧩 Modelo mental de la clase
Necesidad
Usar Django para desarrollar aplicaciones web.
↓
Acción
Instalar el framework dentro del entorno virtual del proyecto.
↓
Resultado
El entorno queda preparado para comenzar a desarrollar aplicaciones con Django.
🚀 Acciones inmediatas
Activar el entorno virtual del proyecto.
Instalar Django dentro del entorno.
Verificar que la instalación fue exitosa consultando la versión.
Prepararse para crear el primer proyecto Django.
💼 Aplicación profesional
Instalar dependencias mediante un gestor de paquetes es una práctica estándar en desarrollo profesional porque permite:
gestionar versiones de librerías
reproducir entornos de desarrollo
compartir proyectos con otros desarrolladores
automatizar la configuración de proyectos
Este mismo proceso se utiliza en prácticamente todos los proyectos Python.
🔥 Hacks para la comunidad
Instala siempre las librerías dentro de un entorno virtual, nunca directamente en el sistema.
Verificar la versión instalada ayuda a evitar problemas de compatibilidad entre tutoriales, proyectos y dependencias.
Cuando trabajes en equipo, todos deben usar las mismas versiones de dependencias para evitar errores inesperados.
📝 Reflexión estratégica
La instalación de librerías es una parte fundamental del desarrollo moderno. Los frameworks, herramientas y dependencias forman el ecosistema que permite construir software complejo sin empezar desde cero.
Entender cómo instalar y gestionar dependencias correctamente es una habilidad básica que permite trabajar de forma profesional en proyectos reales.
para los que quieren empezar a usar uv que está de moda:
uv init django-platzi
cd django-platzi
uv add django
uv pip list
uv run django-admin startproject my_first_project
cd my_first_project
uv run python manage.py runserver
tambien se podria crear dentro de esta carpeta un Makefile
runserver: uv run python manage.py runserver
migrate: uv run python manage.py migrate
createsuperuser: uv run python manage.py createsuperuser
shell: uv run python manage.py shell
asi se ejecutaria con un
make runserver
Gran herramienta para el python moderno.
En esta clase cuento como configurar y usar UV como tu manejador de paquetes.
Cuentame como te va y si tienes dudas por acá estaré!
Django es MVC? vengo de Rails
Es parecido.
En Django se usan Modelos, Vistas y Templates.
Las vistas son como los controlladores de Rails.
Los Templates son como las Views de Rails.
El error "database is locked" que estás recibiendo al ejecutar python manage.py runserver generalmente indica que hay un proceso que mantiene la base de datos SQLite ocupada. Aquí hay algunas soluciones que puedes intentar:
Cierra cualquier conexión abierta: Asegúrate de que no haya otras instancias de tu aplicación Django corriendo o herramientas que estén accediendo a la base de datos.
Reinicia tu entorno de desarrollo: A veces, reiniciar la terminal o el IDE puede liberar la conexión a la base de datos.
Verifica permisos de archivo: Asegúrate de que tu usuario tenga permisos adecuados para acceder y modificar el archivo de la base de datos.
Cambia a otra base de datos: Si el problema persiste, considera cambiar a una base de datos diferente, como PostgreSQL o MySQL, que son más robustas para aplicaciones en desarrollo.
Si continúas teniendo problemas, revisa la documentación de Django sobre el manejo de bases de datos.
Dejo la documentacion para que puedan hacer mas ejemplos practicos.
Insertando el comando django-admin --help nos proporciona la guía de ayuda presentando una lista de comandos base para implementar en nuestro proyecto de Django.
por que a mi me instala la version 4?
Para instalar Django, sigue estos pasos:
Asegúrate de tener un entorno virtual configurado.
Abre la terminal.
Ejecuta el comando: pip install django (sin especificar versión para instalar la última).
Verifica la instalación observando el mensaje de éxito y la versión instalada.
¡Listo! Ahora puedes usar Django en tu proyecto.
thanks for resumen!
More happy that ten tiggers happys
Que debo de hacer si ejecuto "python manage.py runserver" y se me queda la terminal con este mensaje:
Watching for file changes with StatReloader
Queria empezar a estudiar Django pero no sé como solucionar este error.
Hola, resolviste? si la PC es lenta entiendo que puede durar un momento... Si resolviste, favor colocar la solucion para otras personas.