Skip to content

Guia de Instalacion y Despliegue

Jump to bottom
dozelix edited this page Jul 12, 2026 · 3 revisions 
# 🚀 Guía de Instalación y Despliegue

El laboratorio está diseñado para ejecutarse sin fricciones, bloqueos de permisos ni dependencias binarias complejas. Al utilizar la librería `Textual`, todo el entorno interactivo se puede desplegar dentro de un espacio virtual puro de Python, eliminando la necesidad de privilegios de administrador en redes universitarias o corporativas.

## 📋 Requisitos Previos

* **Python 3.10** o superior instalado en el sistema.
* Gestor de paquetes **pip** actualizado.

---

## 🛠️ Configuración en 3 Pasos

### 1. Clonar el repositorio e ingresar al directorio
Abre tu terminal favorita (o la terminal integrada de VS Code) y ejecuta:
```bash
git clone [https://github.com/tu-usuario/tu-repositorio.git](https://github.com/tu-usuario/tu-repositorio.git)
cd tu-repositorio

2. Crear y activar el Entorno Virtual (.venv)

Aislar las dependencias dentro de un entorno virtual garantiza la portabilidad y evita conflictos con librerías globales del sistema.

  • En Linux / macOS:
python3 -m venv .venv
source .venv/bin/activate
  • En Windows (PowerShell / VS Code):
python -m venv .venv
.venv\Scripts\Activate.ps1

(Nota: Si Windows bloquea la ejecución de scripts, puedes habilitarla temporalmente en esa terminal ejecutando Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process).

3. Instalar dependencias puras

Instala los paquetes necesarios definidos en el archivo de requerimientos:

pip install -r requirements.txt

(Dado que Textual es Python puro, se instalará al instante mediante wheels precompilados, sin exigir utilidades externas como Cmake o Zig).

🧪 Preparación del Terreno de Pruebas

Antes de lanzar la interfaz interactiva, es obligatorio inicializar el entorno seguro donde operarán las amenazas emuladas. Este script crea una carpeta dedicada y genera archivos sintéticos (documentos de texto falsos, imágenes base de prueba) que servirán como "víctimas" de las simulaciones.

Generar el directorio controlado:

python core/lab_setup.py

Al finalizar la sesión académica o la práctica de laboratorio, puedes purgar de forma absoluta todos los artefactos, logs y rastros generados en el sistema ejecutando la bandera de limpieza:

python core/lab_setup.py --clean

Clone this wiki locally