Desde la descarga hasta tu primera transcripción en vivo.
Elige Discord, reuniones del navegador o ambas opciones. La aplicación repite esta guía y puede guardar la configuración mientras avanzas.
01 · Escritorio
Instala Kuali en macOS
La versión actual requiere macOS 11 o posterior en Apple Silicon. Homebrew verifica el checksum fijado en el tap de Kuali antes de instalar la aplicación.
Abre Kuali desde Aplicaciones. Durante el primer inicio aparecerá automáticamente la configuración guiada. Podrás volver a ella mediante el botón Guía.
02 · Transcripción
Descarga un modelo de Whisper
Kuali incluye el motor de transcripción, pero descarga los pesos por separado. Debe haber al menos un modelo listo para terminar la configuración inicial. Si no hay ninguno, Kuali mantiene un panel de modelos visible en toda la aplicación en lugar de dejar la transcripción inactiva sin avisar.
Elige el nivel de potencia adecuado para tu Mac
Ligero usa Large v3 Turbo Q5 y es el recomendado para una transcripción en vivo rápida y precisa. Equilibrado usa Large v3 Turbo, Preciso usa Large v3 Q5 para audio difícil y Máxima precisión usa la cuantización reproducible Large v3 Q8 de Kuali. La app muestra la RAM estimada, el tamaño de descarga y el nombre técnico de cada nivel.
Inicia la descarga
Selecciona un modelo en el panel persistente o abre Ajustes → Transcripción → Almacenamiento y pulsa Descargar el modelo seleccionado. El progreso permanece visible mientras usas otras partes de Kuali. Mantén abierta la aplicación hasta que termine la verificación.
Puedes entrar a una llamada durante la descarga
Si la reunión empieza antes de que el modelo esté listo, Kuali conserva en memoria el audio capturado y lo transcribe al terminar la descarga. Nada de lo que ya se capturó se descarta.
Elige dónde guardar los pesos
La carpeta predeterminada es ~/.kuali. Usa Carpeta de los modelos → Elegir… para mover a otra ubicación los pesos completos o parciales. Kuali conserva el idioma y el vocabulario personalizado al moverlos.
Administra los pesos descargados
En Pesos descargados, elimina solamente los modelos que ya no necesites. Si borras el último, el panel persistente vuelve a aparecer hasta que otro modelo esté listo.
El modelo usa RAM solo durante las reuniones
Kuali carga Whisper cuando la primera reunión activa lo necesita, comparte esa instancia entre reuniones simultáneas y la libera al terminar la última. En pruebas sobre Apple Silicon, la app escrita en Rust usó cerca de 40 MB en espera y hasta unos 600 MB al transcribir con el modelo Q5 recomendado. El consumo real varía. Los pesos descargados permanecen en disco.
Añade nombres propios al vocabulario
En Ajustes → Transcripción → Vocabulario personalizado, agrega productos, siglas o personas que Whisper deba conservar.
03 · Discord
Conecta Kuali con Discord en tres pasos simples
Crea, pega y autoriza. Kuali prepara los detalles técnicos y guarda cada paso terminado; tú solamente sigues los botones que aparecen abajo. El token del bot debe tratarse como una contraseña.
Abre Bot, pulsa Restablecer token y copia el valor que muestra Discord. En Kuali, pégalo junto con tu @usuario exacto de Discord, no el nombre visible.
Trata el token como una contraseña. Kuali lo comprueba desde la aplicación de escritorio y nunca lo coloca en la URL de autorización.
Para copiar tu usuario, abre tu perfil desde la esquina inferior izquierda de Discord y pulsa el icono de copiar que aparece junto a él.
Autoriza el servidor
Kuali obtiene el ID de la aplicación desde el token y abre Discord con los ámbitos bot y applications.commands ya preparados. Elige el servidor, pulsa Autorizar, vuelve a Kuali y conecta.
La autorización solicita Ver canales, Enviar mensajes, Enviar mensajes en los hilos, Insertar enlaces, Adjuntar archivos, Conectar, Hablar y Usar actividad de voz; nunca Administrador ni permiso para leer el historial de mensajes.
Con el seguimiento automático activado, Kuali entrará después de ti. Puedes pausarlo desde Inicio o invitarlo manualmente con /grabar o /record.
04 · Meet, Teams y Zoom
Conecta Google Meet en tres pasos simples
Instala, fija y confirma. Chrome Web Store gestiona la extensión y Kuali encuentra la app localmente, sin modo desarrollador ni archivos descomprimidos. Mantén Kuali abierto mientras grabas.
Estado del soporte: Google Meet es estable. Microsoft Teams y Zoom son experimentales y tienen soporte parcial; la captura, la identidad o la separación de hablantes pueden ser incompletas en algunos modos de reunión.
La ficha de Chrome Web Store funciona en Chrome, Edge, Brave y Arc. Pulsa Añadir cuando el navegador pida confirmación.
Fija Kuali
Abre el menú de extensiones del navegador y fija el icono de Kuali para tenerlo disponible durante las reuniones.
Comprueba la conexión local
Entra a una reunión y abre la extensión. Debe indicar que la aplicación está disponible y permitir grabar. El puerto local predeterminado es 9099.
Para desarrollo o si la tienda no está disponible, la guía de escritorio conserva la instalación manual como extensión descomprimida.
05 · Integraciones
Envía reuniones terminadas con Standard Webhooks
Kuali puede entregar una reunión finalizada a las aplicaciones que tú suscribas expresamente. Los envíos siguen la especificación de Standard Webhooks, por lo que puedes validarlos con sus bibliotecas existentes. El contenido incluye la transcripción, participantes, resumen y tareas disponibles; nunca incluye el audio original.
Crea una suscripción
Abre Ajustes → Integraciones → Aplicaciones suscritas, pulsa Añadir aplicación y escribe un nombre junto con la URL que recibirá la solicitud. Usa HTTPS para endpoints fuera de tu computadora.
Elige su alcance
Suscribe la aplicación a todas las reuniones terminadas o limítala a un canal. Kuali envía meeting.completed solamente cuando termina una reunión que coincide y finaliza su procesamiento opcional con IA.
Guarda el secreto de firma
Kuali genera un secreto que empieza por whsec_. Cópialo en la aplicación receptora y mantenlo privado. Usa Enviar prueba para recibir un evento webhook.test antes de depender de la integración.
Verifica la solicitud sin modificar
Valida la firma antes de interpretar el JSON. Standard Webhooks firma los bytes exactos de webhook-id.webhook-timestamp.body mediante HMAC-SHA256.
Verifica el cuerpo original de la solicitud, rechaza timestamps antiguos, compara firmas en tiempo constante y evita procesar dos veces el mismo webhook-id. Devuelve una respuesta 2xx solamente después de aceptar el evento.
Cada solicitud lleva type, timestamp y data en el nivel superior. Los envíos fallidos se reintentan con espera progresiva y variación aleatoria; Kuali respeta un Retry-After numérico cuando existe. Por eso el receptor debe ser idempotente.
06 · Comprobación
Comprueba tu primera llamada
Si puedes, empieza con dos participantes. Hablen por turnos y luego superpongan la voz brevemente para confirmar que la actividad y atribución reaccionan correctamente.
Kuali muestra la reunión dentro de Reuniones en vivo.
El participante activo se ilumina cuando habla.
El texto aparece durante la llamada, no solamente al terminar.
Silenciar a un participante detiene su actividad.
Salir de la reunión la finaliza y libera el modelo de Whisper.
Comandos de Discord
/grabar · /recordInvita a Kuali al canal de voz en el que estás.