Guía local · macOS

Tropical Stereo
Valdivia

Crear desde cero un proyecto Django moderno, usando Python 3.12 y un entorno virtual independiente.

Python 3.12Django 6.1VirtualenvSQLite
1

Comprobar Python

Primero confirma que Python 3.12 está disponible.

Terminal
python3.12 --version
2

Crear carpeta raíz

Esta será la carpeta principal de todo el proyecto.

Terminal
mkdir tropicalstereovaldiviaweb
3

Entrar al proyecto

Trabajaremos desde esta carpeta.

Terminal
cd tropicalstereovaldiviaweb
4

Crear entorno virtual

Separamos las dependencias del proyecto del Python del sistema.

Terminal
python3.12 -m venv tropicalstereovaldiviaenv
Se usa venv, que viene incluido con Python 3.12. No necesitas instalar virtualenv para este proyecto.
5

Activar entorno virtual

A partir de aquí, las instalaciones quedarán dentro del entorno.

Terminal
source tropicalstereovaldiviaenv/bin/activate
6

Actualizar pip

Usamos el pip perteneciente al entorno virtual.

Terminal
python -m pip install --upgrade pip
7

Instalar Django

Instalamos Django 6.1 dentro del entorno virtual.

Terminal
python -m pip install Django==6.1
8

Comprobar Django

Debe mostrar la versión instalada.

Terminal
python -m django --version
9

Crear proyecto Django

El punto final . evita crear una carpeta raíz duplicada.

Terminal
django-admin startproject tropicalstereovaldiviaweb .
10

Aplicar migraciones iniciales

Crea las tablas necesarias de Django en SQLite.

Terminal
python manage.py migrate
11

Crear superusuario

Este usuario permitirá entrar al panel administrativo.

Terminal
python manage.py createsuperuser
12

Levantar servidor

Servidor local de desarrollo.

Terminal
python manage.py runserver
Por defecto Django estará disponible en 127.0.0.1:8000.
13

Usar puerto 3000

Si prefieres trabajar con el puerto 3000.

Terminal
python manage.py runserver 3000
En este caso abre 127.0.0.1:3000 en el navegador.
14

Cuando creemos modelos

Las migraciones propias se hacen después de modificar los modelos.

Terminal
python manage.py makemigrations
python manage.py migrate
Importante: no necesitas ejecutar makemigrations justo después de crear el proyecto si todavía no has creado/modificado modelos.
15

Crear una aplicación Django

Cada módulo funcional puede vivir en su propia app. Ejemplo: noticias.

Terminal
python manage.py startapp noticias
Después agrega noticias a INSTALLED_APPS en settings.py.
16

Crear otra app

Ejemplo para separar programación, música, usuarios u otros módulos.

Ejemplos
python manage.py startapp programacion
python manage.py startapp eventos
python manage.py startapp clientes
python manage.py startapp equipo
python manage.py startapp confian
python manage.py startapp redes
python manage.py startapp contacto
python manage.py startapp player

17

Comprobar configuración del proyecto

Django revisa problemas comunes de configuración.

Terminal
python manage.py check
18

Crear migraciones de tus modelos

Después de crear o modificar modelos en una app.

Terminal
python manage.py makemigrations
19

Aplicar las migraciones

Lleva los cambios de tus modelos a la base de datos.

Terminal
python manage.py migrate
20

Ver las migraciones

Muestra cuáles están aplicadas y cuáles están pendientes.

Terminal
python manage.py showmigrations
21

Abrir el shell de Django

Permite probar modelos y consultas directamente desde Python.

Terminal
python manage.py shell
22

Ver las URLs del proyecto

El archivo principal de rutas se encuentra en la carpeta del proyecto.

Terminal
ls tropicalstereovaldiviaweb
23

Guardar dependencias del proyecto

Muy recomendable antes de compartir, respaldar o desplegar el proyecto.

Terminal
pip freeze > requirements.txt
Este archivo permite reconstruir posteriormente el entorno con las mismas dependencias.
24

Instalar dependencias desde requirements.txt

Útil cuando clonas el proyecto en otro equipo o servidor.

Terminal
pip install -r requirements.txt
25

Crear archivo .gitignore

Evita subir archivos innecesarios o secretos al repositorio.

Terminal
touch .gitignore
Recomendado: no subas db.sqlite3, archivos de entorno virtual ni secretos como claves API.
26

Detener el servidor

Cuando el servidor esté corriendo en Terminal.

Terminal
CTRL + C
27

Desactivar el entorno virtual

Úsalo cuando termines de trabajar con el proyecto.

Terminal
deactivate
28

Checklist antes de avanzar

Una base limpia ahora te ahorrará problemas después.

✓ Entorno virtual activo
✓ Python 3.12 funcionando
✓ Django instalado
✓ settings.py configurado
✓ Apps registradas en INSTALLED_APPS
✓ Migraciones aplicadas
✓ Superusuario creado
✓ requirements.txt generado
✓ .gitignore preparado