El WiBot Security Agent es un programa instalado en una PC local del negocio. Se conecta a las cámaras, analiza el video con inteligencia artificial (YOLOv8) y envía alertas al dashboard web y por WhatsApp cuando detecta actividades sospechosas.
| Módulo | Qué detecta | Severidad |
|---|---|---|
| 💰 Caja Registradora | Productos entregados sin escanear. Actividad no registrada en POS. | Crítico |
| 💵 Billetes | Denominaciones AWG, USD, EUR, ANG. Discrepancias con el POS. | Crítico |
| 👨🍳 Cocina | Movimientos sospechosos de empleados hacia bolsillos o bolsos. | Advertencia |
| 🛒 Tienda | Clientes ocultando productos en bolsos. Comportamiento de robo. | Crítico |
| Componente | Mínimo | Recomendado | Estado |
|---|---|---|---|
| Sistema Operativo | Windows 10 64-bit | Windows 10/11 64-bit | Compatible |
| Procesador | Intel Core i5 / Ryzen 5 | Intel Core i7 / Ryzen 7 | Requerido |
| RAM | 8 GB | 16 GB | Recomendado |
| Almacenamiento | 10 GB libres | 50 GB SSD | Requerido |
| GPU NVIDIA | No requerida | RTX 3060 o superior | Opcional |
| Internet | 5 Mbps upload | 20 Mbps upload | Requerido |
| Python | 3.9+ | 3.11 | Incluido |
python --version # Debe mostrar: Python 3.11.x pip --version # Debe mostrar: pip 23.x from C:\...
:: Crear carpeta WiBot en C:\ mkdir C:\WiBot cd C:\WiBot :: Descargar archivos del agente curl -o wibot_agent.py https://wibotsecurity.com/agent/wibot_agent.py curl -o instalar.bat https://wibotsecurity.com/agent/instalar_windows.bat curl -o requirements.txt https://wibotsecurity.com/agent/requirements.txt
cd C:\WiBot instalar.bat # El instalador ejecuta automáticamente: # pip install ultralytics opencv-python requests numpy # Descarga modelo YOLOv8 (~6MB) # Tiempo estimado: 3-5 minutos
Edita la sección CONFIG al inicio del archivo C:\WiBot\wibot_agent.py con el Bloc de Notas o VS Code.
| Tipo | Ejemplo | Uso |
|---|---|---|
| Webcam USB | 0 o 1 | Cámara USB conectada al PC (0 = primera) |
| IP Camera RTSP | rtsp://admin:pass@192.168.1.100:554/stream1 | Cámaras IP en la red local |
| MJPEG Stream | http://192.168.1.50:8080/?action=stream | App IP Webcam en Android |
| HLS / MP4 | https://ejemplo.com/stream.m3u8 | Streams remotos |
"cameras": [ { "cam_key": "CAM-POS-01", # ID único de la cámara "label": "Caja Principal", # Nombre descriptivo "module": "pos", # pos/kitchen/store/bills "source": 0, # 0=webcam USB, o URL RTSP "enabled": True }, { "cam_key": "CAM-KIT-01", "label": "Cocina Principal", "module": "kitchen", "source": "rtsp://admin:1234@192.168.1.101:554/stream1", "enabled": True }, { "cam_key": "CAM-STR-01", "label": "Pasillo A", "module": "store", "source": "rtsp://admin:1234@192.168.1.102:554/stream1", "enabled": True } ]
| Marca | URL RTSP típica |
|---|---|
| Hikvision | rtsp://admin:PASSWORD@IP:554/Streaming/Channels/101 |
| Dahua | rtsp://admin:PASSWORD@IP:554/cam/realmonitor?channel=1&subtype=0 |
| TP-Link Tapo | rtsp://USER:PASSWORD@IP:554/stream1 |
| Reolink | rtsp://admin:PASSWORD@IP:554//h264Preview_01_main |
| Genérica / China | rtsp://admin:12345@IP:554/stream1 |
WiBot usa CallMeBot (gratuito) para enviar mensajes de WhatsApp al gerente cuando se detecta una alerta crítica.
cd C:\WiBot python wibot_agent.py
Al iniciarse correctamente verás en la consola:
[02:30:15] [INFO] Conectando a https://wibotsecurity.com/api/agent.php... [02:30:16] [OK] Servidor conectado: WiBot Security [02:30:16] [INFO] Cargando YOLOv8 desde yolov8n.pt... [02:30:18] [OK] YOLOv8 cargado correctamente [02:30:18] [INFO] Iniciando 1 camara(s)... [02:30:19] [OK] Camara CAM-POS-01 conectada [02:30:19] [OK] Sistema WiBot activo. Presiona Q para salir.
Detecta personas en la zona de caja. Envía alerta de advertencia cuando detecta actividad de alta confianza sin transacción registrada en el POS.
Monitorea empleados en cocina. Detecta movimientos hacia bolsillos usando análisis de posición corporal. Umbral de confianza: 75%.
Detecta cuando una persona lleva bolso/mochila y el objeto está cerca del cuerpo en zona de estantes. Envía alerta crítica con WhatsApp inmediato.
:: Crear script de inicio automático en carpeta Startup de Windows echo @echo off > "%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\wibot.bat" echo cd C:\WiBot >> "%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\wibot.bat" echo python wibot_agent.py >> "%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\wibot.bat" echo WiBot configurado para inicio automatico.
setx PATH "%PATH%;C:\Users\TU_USUARIO\AppData\Local\Programs\Python\Python311"pip install ultralytics opencv-python requests numpy