Para cursos avanzados que requieren hardware local (p. ej. Arduino) o máquinas virtuales aisladas (Ubuntu Lab VM), el Agente Local (xkat-cli) conecta su navegador con su computadora de manera segura.
Aviso de Seguridad: El agente local nunca abre puertos a Internet. Se comunica exclusivamente dentro de su propia máquina (
localhost:127.0.0.1). Los comandos solo se ejecutan con su autorización.1. Inicio Rápido (Quick Start)
Abra el terminal de su computadora (PowerShell, Terminal o Bash) y ejecute este comando:2. Guía por Sistema Operativo
- Windows
- macOS
- Linux
Configuración en Windows
- Terminal: Abra PowerShell, Windows Terminal o el Símbolo del sistema (CMD).
- Comando:
- Para Prácticas con Máquina Virtual (Lab VM):
- Se recomienda Windows 10/11 de 64 bits.
- Abra el Administrador de tareas (Ctrl+Shift+Esc) → pestaña [Rendimiento] y compruebe que Virtualización: Habilitado esté activo.
3. Solución de Problemas (Troubleshooting)
Si experimenta algún inconveniente de conexión, consulte las siguientes soluciones:1. Comando 'npx' o 'node' no reconocido
1. Comando 'npx' o 'node' no reconocido
Esto ocurre cuando el entorno Node.js no está instalado en su sistema.
- Windows: Descargue e instale la versión LTS desde nodejs.org o use PowerShell:
- macOS: Instale desde nodejs.org o mediante Homebrew:
- Linux (Ubuntu/Debian):
npx -y xkat-cli@latest up.3. Error al crear o iniciar la Máquina Virtual (Ubuntu Lab VM)
3. Error al crear o iniciar la Máquina Virtual (Ubuntu Lab VM)
- Virtualización en Windows:
- Si en el Administrador de tareas la Virtualización figura como Deshabilitada, acceda a la configuración BIOS/UEFI al reiniciar el PC y active Intel VT-x o AMD SVM.
- Reinicio completo de la VM:
- Ejecute el siguiente comando para regenerar la máquina virtual desde cero:
- Ejecute el siguiente comando para regenerar la máquina virtual desde cero:
4. Cómo detener el agente al terminar la práctica
4. Cómo detener el agente al terminar la práctica
Para detener los procesos en segundo plano de manera segura: