El repositorio oficial de RuView en GitHub es el mejor lugar para revisar código, issues, notas de instalación, ruta Docker, referencias de modelos e historial del proyecto. La página principal de ruview.blog sigue siendo la forma más rápida de abrir la demo alojada; esta guía sirve como puente para desarrolladores.
RuView es un proyecto abierto de WiFi sensing e inteligencia espacial, no un monitor médico ni un sistema de seguridad terminado. Lee el repositorio como un proyecto de ingeniería: confirma cambios recientes, revisa si la demo coincide con el código y valida cualquier supuesto de hardware antes de confiar en presencia, movimiento, respiración o pose.
Dónde está el repositorio oficial de RuView
El repositorio público es github.com/ruvnet/RuView. Trátalo como fuente canónica para código, documentación, issues, releases y cambios de instalación. Si llegas desde un espejo, vídeo o README en caché, vuelve al repositorio antes de copiar comandos.
La demo alojada en ruvnet.github.io/RuView/ sirve para explorar la interfaz, pero no sustituye al repositorio. La demo muestra el flujo de usuario; GitHub muestra implementación, dependencias, commits recientes y limitaciones abiertas.
- Abre primero el README y después issues y releases.
- Usa la URL del repositorio al citar RuView.
- Conserva ruview.blog para revisiones rápidas en navegador.
Qué revisar primero en ruvnet/RuView
Una primera revisión puede durar menos de diez minutos. Lee el README, inspecciona el árbol del proyecto y busca carpetas de frontend, firmware, modelos, Docker y documentación. Después mira commits e issues recientes para saber si las instrucciones están estables.
No empieces por promesas de precisión. En proyectos WiFi sensing importan primero el hardware CSI, la repetibilidad de captura, la calibración y si la demo se parece a tu entorno.
| Área | Qué indica | Por qué importa |
|---|---|---|
| README y docs | Comandos, objetivo, rutas soportadas | Evita instrucciones obsoletas |
| Issues y releases | Errores, roadmap, reportes | Distingue experimental de estable |
| Docker o despliegue | Ruta local y dependencias | Permite reproducir sin adivinar |
| Firmware o CSI | Nodos y captura esperada | Separa CSI real de RSSI |
Demo alojada frente a instalación local
Usa la demo alojada para inspeccionar rápido la interfaz o explicar el concepto. Usa una instalación local cuando quieras cambiar código, ver logs, conectar hardware o depurar por qué una escena WiFi no se repite.
El flujo más seguro es escalonado: abre la demo de ruview.blog, abre GitHub, revisa el README, ejecuta la ruta local más simple y solo después conecta hardware CSI real.
- Demo primero para orientación.
- Repositorio después para comandos y límites actuales.
- Instalación local para código, logs y hardware.
Comprobación de hardware y WiFi CSI
RuView necesita detalle de señal. Muchos dispositivos WiFi exponen RSSI, pero no Channel State Information útil. ESP32 CSI es una ruta económica; investigación avanzada puede requerir varios nodos, sincronización y datos etiquetados.
Antes de interpretar resultados, registra una línea base, anota canal WiFi, estabiliza paquetes y documenta la colocación. Presencia en una sala fija es mucho más simple que pose, respiración o varias personas.
| Objetivo | Inicio probable | Nota de validación |
|---|---|---|
| Abrir demo | Navegador y GitHub Pages | Solo confirma interfaz |
| Ejecutar local | Setup o Docker | Confirma entorno |
| Capturar CSI | ESP32 compatible o hardware de investigación | Confirma señal |
| Evaluar sensing | Pruebas etiquetadas repetidas | Confirma realidad |
Lista práctica antes de clonar
Antes de clonar el repositorio, define qué tipo de prueba harás. Una revisión en navegador solo necesita la demo alojada y el README. Una revisión local necesita Python, Node, Docker o el runtime que indique el README actual. Una revisión de sensing necesita hardware WiFi compatible, una sala repetible y una forma de etiquetar cada prueba. Separar objetivos evita depurar hardware antes de confirmar que el software funciona.
Crea notas para cada experimento. Anota commit o release, sistema operativo, navegador, imagen Docker o versiones de paquetes, placa sensora, firmware, canal WiFi, posiciones de emisor y receptor, tamaño de sala y escena exacta. Estos datos permiten comparar resultados de RuView entre sesiones y explicar por qué una presencia funcionó en una sala pero no en otra.
- Confirma el README actual antes de copiar comandos externos.
- Elige un objetivo: demo, ejecución local o captura CSI real.
- Registra commit, versiones, hardware, canal, posición y línea base.
Cómo validar un resultado de RuView con prudencia
La validación debe ser visible y conservadora. Para presencia, prueba sala vacía, una persona entrando, una persona sentada, movimiento de puerta sin persona y entradas repetidas desde varias direcciones. Para movimiento o pose, revisa si el sistema responde al cuerpo esperado o solo a un cambio multipath fuerte cerca de la antena. Para respiración o señales vitales, trata cualquier número como señal de investigación hasta compararlo con una referencia independiente.
Un buen flujo RuView GitHub incluye ejemplos negativos: momentos sin actividad, tráfico irregular del router, cambios de muebles, varias personas y pequeñas variaciones de sensor. Estos casos muestran si la tubería es robusta o solo está ajustada a una demo limpia. Documentar límites vale más que una captura bonita sin contexto.
- Prueba escenarios vacíos y falsos positivos.
- Compara señales de salud con referencias independientes.
- Mantén límites junto a capturas, informes y demos.
Errores comunes al buscar RuView GitHub
El error más común es tratar un vídeo o artículo como más reciente que el repositorio. Otro es asumir que una demo funcional garantiza que tu hardware funcionará en tu habitación. También conviene evitar usar RuView como producto médico o de seguridad certificado.
La frontera de intención queda clara: la home cubre marca y demo, la guía ESP32 explica captura CSI y esta página explica cómo usar GitHub como referencia técnica.
- No copies comandos antiguos sin revisar GitHub.
- No llames CSI a datos solo RSSI.
- No interpretes señales de salud sin validación independiente.
Enlaces oficiales y referencias técnicas
Preguntas frecuentes sobre RuView GitHub
¿Dónde está el repositorio oficial?
El repositorio público oficial es https://github.com/ruvnet/RuView. Úsalo para código, notas de setup, issues y estado actual.
¿La demo alojada es lo mismo que GitHub?
La demo permite revisar la experiencia en navegador; GitHub contiene código, documentación, dependencias e historial.
¿Puedo usar RuView sin ESP32?
Puedes revisar la demo y algunas rutas de software, pero el sensing real necesita hardware compatible que exponga CSI útil.
¿RuView está listo para decisiones médicas?
No. Es software abierto de investigación y prototipado; salud, caídas y seguridad requieren validación independiente.