- ¿Qué es un proyecto Django?
- Crear el entorno y proyecto
- Estructura de un proyecto Django
- Ejecutar el servidor de desarrollo
- El script manage.py
En este paso del camino ya sabes bastante de Python, lo suficiente para empezar a trabajar con uno de los frameworks más populares para desarrollo web: Django. En esta lección vamos a crear nuestro primer proyecto en Django y a correrlo en modo local. No te preocupes si al principio todo parece complejo — vamos paso a paso.
¿Qué es un proyecto Django?
El proyecto es una especie de “contenedor” que incluye todo lo necesario para una aplicación web: archivos de configuración, URLs, aplicaciones internas, etc.
Django ya trae varias cosas listas para ayudarte a organizarlo.
Vamos a crear uno que vamos a ir desarrollando poco a poco en el curso: un blog llamado codica-django-blog.
Crear el entorno y proyecto
Primero, exploremos cómo configuramos nuestro entorno de trabajo:
Paso 1: Crear el directorio del proyecto
Abre tu terminal, navega hasta la carpeta donde quieres trabajar y crea una subcarpeta:
mkdir codica-django-blog
cd codica-django-blog
Paso 2: Instalar Django
Si estás usando la herramienta uv, puedes instalar Django así:
uv pip install django
Si no usas uv, simplemente ejecuta:
pip install django
Ahora verifica que la instalación está correcta:
# Para saber la versión de Django instalada
uv run django-admin version # Con uv
# o sin uv
django-admin version
La versión mostrada debe ser al menos 4.x. Por ejemplo:
4.1.2
Paso 3: Crear el proyecto
Aún estando dentro de la carpeta codica-django-blog, ejecuta:
uv run django-admin startproject codica_django_blog .
(Si no estás usando uv, simplemente omítelo y ejecuta el resto del comando.)
Veamos qué significa esta línea:
codica_django_bloges el nombre de tu proyecto en formato Python (usa guion bajo).- El punto al final (
.) le dice a Django que lo cree en la carpeta actual.
Estructura de un proyecto Django
Al ejecutar el comando anterior, Django crea varios archivos automáticamente. Aquí hay una tabla para entender qué es cada uno:
| Archivo | Para qué sirve |
|---|---|
manage.py |
Herramienta para administrar el proyecto durante el desarrollo. Ejecuta comandos como iniciar el servidor. |
settings.py |
Aquí están todas las configuraciones del proyecto: idioma, base de datos, apps instaladas, etc. |
urls.py |
Aquí se especifica qué URLs están asociadas a qué vistas. Es como el mapa de rutas de tu sitio web. |
wsgi.py y asgi.py |
Son puntos de entrada para servidores que usan WSGI o ASGI (protocolos de ejecución en servidores web). |
En este curso nos vamos a enfocar principalmente en dos de estos archivos:
settings.pyurls.py
Más adelante los modificaremos para agregar aplicaciones, vistas y configuración personalizada.
Ejecutar el servidor de desarrollo
¡Listo, llegó el momento de ver Django en acción!
Estamos todavía en modo desarrollo, así que Django trae un servidor básico que se reinicia solo, y no guarda caché (ideal para desarrollar).
Para levantar el servidor, ejecuta:
python manage.py runserver
Te debe aparecer algo como:
Watching for file changes with StatReloader
Performing system checks...
System check identified no issues (0 silenced).
You have 18 unapplied migration(s)...
Starting development server at http://127.0.0.1:8000/
Quit the server with CTRL+C.
Para ver el sitio, abre tu navegador y entra a:
http://127.0.0.1:8000
Verás algo como esto:
Esta es la página de bienvenida de Django. Si la ves, todo está funcionando correctamente.
Para apagar el servidor, regresa al terminal donde lo iniciaste y presiona CTRL+C.
El script manage.py
Este archivo lo crea Django automáticamente y lo vamos a usar muchísimo. Es como el “centro de mando” del proyecto.
Ejecuta esto para ver todas las opciones disponibles:
python manage.py
Entre las cosas que puedes hacer con manage.py están:
- Crear nuevas aplicaciones dentro del proyecto.
- Ejecutar pruebas automatizadas.
- Aplicar cambios a la base de datos.
- Iniciar una consola interactiva con el contexto del proyecto.
A medida que avancemos, vamos a usar muchas de estas tareas acompañadas por manage.py, así que no te preocupes si ahora suena un poco técnico.
Resumen
- Django es un framework potente para desarrollar aplicaciones web con Python.
- Para iniciar un proyecto Django, usamos el comando
startproject. - La estructura creada incluye archivos esenciales como
settings.py,urls.pyymanage.py. manage.pyes el script principal para administrar tu proyecto: desde iniciar el servidor hasta manejar la base de datos.- Para desarrollar localmente, usamos
python manage.py runserver.
Nos vemos en la próxima lección, donde empezaremos a construir nuestra primera aplicación dentro del proyecto.
Trabajo independiente
Prepara y sube tu proyecto a GitHub
En esta actividad vamos a repasar lo aprendido y publicar tu proyecto en GitHub. Sigue estos pasos:
- Repite todo lo de la teoría de la lección en tu computadora.
- Crea un repositorio en GitHub llamado
codica-django-blog. - Sube allí el proyecto.
Materiales adicionales
Para acceder completo a curso necesitas un plan básico
El plan básico te dará acceso completo a todos los cursos, ejercicios y lecciones de Códica, proyectos y acceso de por vida a la teoría de las lecciones completadas. La suscripción se puede cancelar en cualquier momento.
