¿Deseas probarlo? Entra a la web
RAZR es un sistema que permite el monitoreo autónomo de somnolencia en tiempo real.
Este documento describe los pasos para configurar el entorno, instalar dependencias y ejecutar el script razr.py.Antes de comenzar, asegúrate de tener instaladas las siguientes herramientas:
- Python 3.10+
- pip (gestor de paquetes de Python)
- virtualenv (opcional, pero recomendado)
- Cámara web (para la captura en tiempo real)
- Archivo de audio alarma.wav (para el aviso acústico)
Se recomienda aislar el proyecto en un entorno virtual para evitar conflictos de dependencias.
En Windows (PowerShell o CMD)
python -m venv venv
En Linux / macOS
python3 -m venv venv
En Windows
venv\Scripts\activate
En Linux / macOS
source venv/bin/activate
Nota: Verás que el prompt cambia para indicar que estás dentro del entorno virtual, por ejemplo:
(venv) user@machine:~/razr$
Una vez activado el entorno virtual, instala los paquetes necesarios:
pip install -r requirements.txt
Ejecuta el script principal del sistema desde la terminal:
python razr.py --ruta-alarma alarma.wav --mostrar-grafico --audio-activo
Argumentos opcionales
Parámetro Descripción Valor por defecto
--ruta-alarma Ruta del archivo .wav alarma.wav para la alerta sonora
--indice-camara Índice del dispositivo 0 de cámara
--umbral-ear Umbral de EAR para 0.16 activar la alarma
--tiempo-umbral Tiempo mínimo (seg) 1.0
que debe mantenerse
por debajo del EAR
--duracion-alarma Duración de la alarma 5 en segundos
--mostrar-grafico Muestra el gráfico del False EAR en tiempo real
--audio-activo Activa el sonido de False alarma
Cuando termines de trabajar, puedes salir del entorno virtual con:
deactivate
Para comprobar que las dependencias se instalaron correctamente:
python -m pip list
Y asegúrate de ver las versiones esperadas de cada paquete (por ejemplo, mediapipe 0.10.21, opencv-python 4.9.0.80, etc.).