HALL EDU — TU PRIMERA CLASE

Esta versión funciona en el Mac y guarda allí tus clases. No necesitas instalar
Node, usar comandos ni crear una cuenta de Hall Edu. El archivo descargado debe
corresponder a la arquitectura de tu Mac. Esta entrega es una versión Preview.

1. INSTALA Y ABRE

Abre el DMG y arrastra Hall Edu a Aplicaciones. Luego abre Hall Edu desde
Aplicaciones. También puedes descomprimir el ZIP y copiar la aplicación.

Esta versión todavía no tiene firma Developer ID ni notarización de Apple.
Revisa las instrucciones de instalación incluidas antes de abrirla. Si macOS bloquea la apertura
por desarrollador no identificado, y confías en quien te la entregó, intenta
abrirla una vez y luego ve a Configuración del Sistema > Privacidad y seguridad
> Abrir de todos modos. Un Mac administrado por tu institución puede requerir
ayuda de su equipo de soporte. No desactives las protecciones del equipo.

2. CONFIGURA UNA SOLA VEZ

Hall Edu abre el asistente de configuración en tu navegador. El espacio que
ves se ejecuta en este computador.

- Confirma nombre, idioma y zona horaria.
- Crea tu curso y agrega su horario semanal, incluidas las fechas de inicio
  y término. Así Hall Edu podrá crear las carpetas de cada clase.
- Para que todo siga automáticamente después de recibir el audio, selecciona
  el modo API. Guarda y prueba una clave de Deepgram o Speechmatics para la
  transcripción y una de OpenAI o Gemini para el análisis. Indica también
  el modelo de análisis. Estos servicios tienen sus propios cobros y requieren
  Internet. Una prueba de conexión no garantiza saldo ni acceso al modelo.
- Puedes dejar las API pendientes. En ese caso, la aplicación organiza tus
  carpetas, pero no transcribe ni analiza automáticamente sin los servicios
  correspondientes.
- Confirma el consentimiento de grabación solo cuando cuentes con la
  autorización necesaria y hayas informado a quienes corresponda.

Puedes retomar el asistente sin volver a crear el mismo curso y horario.
Para volver a tu espacio, usa Configurar Hall Edu o Abrir mis clases en la app.

3. DEJA EL MATERIAL DE CADA CLASE

Hall Edu organiza tu biblioteca por curso, período y número de clase. Abre
la ubicación que muestra la aplicación. Dentro de cada clase encontrarás:

  Material/          Tu presentación: un archivo PPTX o PDF.
  Audio/             La grabación de esa clase.
  Transcripciones/   Una transcripción externa, si ya cuentas con ella.
  Borradores/        El PPT propuesto para esa clase.

Deja una sola presentación y una sola grabación como fuentes de cada clase.
Los PPT antiguos con extensión .ppt deben guardarse como .pptx antes de copiarlos.
Hall Edu detecta los archivos automáticamente mientras permanece abierto.
También puedes usar Revisar ahora para solicitar una revisión de las carpetas.

Una transcripción externa con tiempos, en JSON, VTT, SRT, MD o TXT compatible,
puede evitar el servicio de transcripción. Un texto sin tiempos no permite
reconstruir de forma fiable las métricas de participación.

4. USA EL TELÉFONO

Android: instala Hall Edu Preview desde https://hall-edu.pages.dev y autoriza
la instalación cuando Android lo solicite. La Preview se instala por separado
de la app anterior. Conecta el teléfono y el Mac a la misma Wi-Fi privada.
En Dispositivos, pulsa Vincular teléfono. Escanea el QR o copia el enlace,
pégalo en la app Android y confirma el Mac mostrado. El enlace dura diez
minutos y se puede usar una sola vez. La identidad del Mac queda guardada
en el teléfono y las transferencias nativas usan HTTPS cifrado.

Confirma los permisos de micrófono y notificaciones en Android. Elige tu clase
e inicia la grabación explícitamente. Al detenerla, la app intenta enviarla
al Mac. Conserva el audio pendiente si la conexión falla y permite reintentar.
Mantén Hall Edu abierto y el Mac despierto. La conexión se vuelve a abrir
al abrir Hall Edu; si cambia la dirección de red, genera un enlace nuevo
y vuelve a vincular. Resuelve las grabaciones pendientes antes de cambiar
el destino: la app evita entregar el audio a otro espacio por accidente.

iPhone u otro teléfono: usa tu grabadora habitual y guarda el archivo.
Abre la opción de subir archivo por Wi-Fi en Dispositivos, genera un enlace
y selecciona la clase y el audio. Mantén la página abierta durante la carga.
Esta alternativa usa HTTP local SIN cifrado, solo en una red privada de
confianza; máximo 90 MiB por archivo. No graba desde el navegador.

Conectar un cable USB no instala ni autoriza la app por sí solo. Si la red
de tu institución impide la comunicación entre equipos, transfiere el archivo
al Mac por tu método habitual y cópialo a Audio/.

5. REVISA LO QUE PASÓ Y PREPARA LA SIGUIENTE CLASE

Después de procesar el material, encontrarás la transcripción, el análisis,
las métricas y la preparación en tu espacio y en las carpetas correspondientes.
La duración del procesamiento depende del audio, Internet y los proveedores;
los resultados no están disponibles de forma instantánea al detener la grabación.

Mantén habilitados los borradores automáticos y crea la siguiente sesión en
el horario. Cuando haya una preparación nueva, Hall Edu generará su PowerPoint
en Borradores/ de esa próxima clase. Revisa y edita el borrador; copia la versión
aprobada a Material/. El borrador puede tomar la fuente y el color de un PPT
anterior, pero no reproduce automáticamente todas sus imágenes y diagramaciones.

OPCIONAL: USA TU ASISTENTE MEDIANTE MCP

En Ajustes > Análisis elige MCP y crea el acceso. La aplicación muestra los
valores de conexión para clientes de escritorio compatibles con MCP local
(stdio). Instala Hall Edu en su ubicación definitiva antes de copiarlos.
Guarda la configuración en tu asistente y ejecuta el mensaje de prueba que
entrega Hall Edu. La conexión aparece verificada después de una prueba válida.

En modo MCP, tu asistente debe ejecutar el análisis. Crear la conexión no
programa una rutina automática. Para procesamiento desatendido, usa el modo API.
La conexión local no habilita por sí sola ChatGPT web. Conectar el servidor
a ChatGPT por la nube requiere además un endpoint HTTPS público autenticado
o Secure MCP Tunnel. Ese despliegue y la interoperabilidad con tu cliente
concreto no forman parte de la verificación de esta Preview.

ANTES DE CERRAR

Mantén Hall Edu abierto y el Mac despierto durante cargas y procesamiento.
Cerrar la ventana deja la app en la barra de menú; salir de la app detiene
su servidor. Tus cursos y archivos se conservan para la próxima apertura.
No se importan automáticamente los datos de una instalación alojada en la nube.

Para respaldar, cierra Hall Edu y copia la carpeta de datos completa que puedes
abrir desde Ajustes, junto con cualquier biblioteca que hayas elegido aparte.

Referencias de configuración (consultadas el 9 de septiembre de 2026):
Apple: https://support.apple.com/en-us/102445
ChatGPT/MCP: https://developers.openai.com/plugins/deploy/connect-chatgpt
