Todas las apps de Studio
Visión & CCTV Edge

Demografía

edad · género · emoción

Estimá edad, género y emoción por rostro — localmente con InsightFace, o vía una API de visión opt-in con un tope de presupuesto mensual.

streamhub.studio/studio/demography

Vista previa de la interfaz próximamente

El problema

Entender quién está frente a una cámara — banda de edad aproximada, distribución de género, ánimo — suele significar un contrato de analítica cloud pago. Demografía lo hace sobre un modelo local abierto que es tuyo, al intervalo que fijás, y solo opcionalmente enruta capturas a una API de visión cuando vos decidís que el costo vale la pena.

Casos de uso

Retail

Mix de audiencia

Un desglose aproximado de edad y género de quién pasa por una sección o una exhibición, muestreado a un intervalo, para informar el merchandising — sin una tarifa cloud por rostro.

Cartelería / Media

Engagement anónimo

Estimá la demografía y el ánimo de los espectadores frente a una pantalla para medir el engagement, sin guardar identidad — solo edad / género / emoción agregados.

Locales

Perfil de visitantes

Muestreá la multitud periódicamente para un perfil agregado de los asistentes a lo largo de un día o un evento.

Cómo funciona

Entrada

HLS en vivo + ROI opcional

Un worker muestrea el stream en vivo por HLS al intervalo configurado. Podés dibujar una región de interés opcional sobre un frame en vivo para que solo se analicen los rostros dentro de ella.

Detección

InsightFace, o una API de visión

Por defecto InsightFace (buffalo_l) corre localmente para edad, género y emoción. Cambiá el motor a OpenAI o DeepSeek para enviar capturas a una API de visión en su lugar, con un tope de presupuesto mensual que corta en seco el gasto excedido.

Callback firmado

demography.face

Cada rostro emite demography.face con la edad, el rango de edad, el género, la emoción y el motor usado, por los callbacks firmados con HMAC de la app (webhook + MQTT).

Tu sistema

Resumen + tu flujo

Los rostros recientes se ven en la pestaña de la app; cada registro persiste en la base de datos propia de demografía de la app para tu reporte agregado.

Eventos que emite

Declarados en el manifiesto del plugin y retransmitidos por los callbacks firmados con HMAC de la app (webhook + MQTT). Cualquier cosa que un worker intente emitir fuera de esta lista se rechaza — sin suplantar eventos del core.

demography.face

Alcance y límites

  • Estima atributos agregados por rostro — no es reconocimiento de identidad y no guarda identidad, solo edad / género / emoción.
  • Las estimaciones son aproximadas y se degradan con la distancia, el ángulo y la iluminación; tratalas como señal agregada, no como verdad por persona.
  • En un nodo edge la clave de la API de IA se retiene deliberadamente de la asignación — la demografía con motor de API queda como asunto co-ubicado; el motor local InsightFace se distribuye sin problema.

Requisitos mínimos

  • Motor local: el extra [demography] agrega InsightFace + onnxruntime + el modelo buffalo_l (~300 MB); presupuestá ~1,5 GB de RAM por worker. Como muestrea a un intervalo, la CPU es viable.
  • Los motores de API (OpenAI / DeepSeek) no necesitan ni InsightFace ni GPU — solo el intervalo, un prompt y un tope de presupuesto mensual.
  • GPU opcional para el motor local: cualquier GPU CUDA acelera el análisis de rostros; el guard de presupuesto, no el hardware, acota el costo de la API.

Los números son mediciones honestas de los autores del plugin, no marketing. La GPU es opcional en cada plugin de visión salvo donde se indique.

Corre como una app completa

Cada app de Studio es una aplicación de primera clase, no un modal de configuración — y no tiene por qué vivir dentro de StreamHub.

Vista de página completa en el dashboard

Se abre como su propia página dentro de la app tenant — zonas, paneles en vivo, historial y ajustes en una sola superficie, no apretados en un diálogo.

Su propia base de datos

Guarda su estado en una base SQLite dedicada por app — lecturas, alertas, ocupación y filas de evidencia — que es tuya y podés consultar.

Bundle exportable

Descargá la app como un bundle autocontenido — worker, Dockerfile, compose y una plantilla de env — para hostearla en tu propia infra y extenderla, hablando de vuelta por la API REST y los webhooks firmados.

¿Tenés cámaras o streams para poner a trabajar?

Contanos qué estás monitoreando y definimos las apps correctas, las conectamos a tus sistemas y las operamos con vos. El software es open source — el despliegue y la operación es lo que hacemos.