SentrySearch: Búsqueda Semántica de Video con IA
SentrySearch: Revoluciona el Análisis de Grabaciones de Video con Búsqueda Semántica
Encontrar momentos específicos en horas de grabaciones de video acaba de volverse dramáticamente más fácil. SentrySearch es una herramienta de Python de código abierto que utiliza modelos de embedding de video de vanguardia para hacer que tus videos sean buscables mediante consultas en lenguaje natural.
Cómo Funciona (Magia Pura)
En lugar de avanzar manualmente por las grabaciones, SentrySearch: 1. Divide tus videos en segmentos superpuestos de 30 segundos 2. Incrusta cada segmento usando la API de Gemini Embedding de Google o modelos locales Qwen3-VL 3. Almacena los embeddings en una base de datos vectorial local ChromaDB 4. Empareja tu consulta de texto ("coche pasando semáforo en rojo") con los embeddings de video 5. Recorta automáticamente y guarda el clip que mejor coincida
Sin transcripción. Sin subtitulación de fotogramas. Emparejamiento semántico directo de video a texto.
🚀 Inicio Rápido (5 Minutos)
# Instalar con uv (el gestor de paquetes más rápido)
curl -LsSf https://astral.sh/uv/install.sh | sh
git clone https://github.com/ssrajadh/sentrysearch.git
cd sentrysearch
uv tool install .
# Configurar clave API (disponible nivel gratuito)
sentrysearch init
# Indexar tus grabaciones
sentrysearch index /path/to/videos
# Buscar y obtener clips!
sentrysearch search "camión rojo pasando semáforo de stop"
Resultado: ./match_front_2024-01-15_14-30_02m15s-02m45s.mp4 ✅
🌐 Dos Backends: Nube o Local
| Backend | Pros | Cons | Coste |
|---|---|---|---|
| Gemini API (predeterminado) | Mejor calidad, no necesita GPU | Requiere clave API | ~$2.84/hora indexada |
| Local Qwen3-VL | Gratis, privado, offline | Necesita GPU/Mac M1+ | Gratis |
El modelo local se autoescala a tu hardware: - NVIDIA 18GB+ VRAM: Qwen8B (precisión completa) - 8-16GB VRAM: cuantizado 4-bit (~6GB) - Mac M1/M2 16GB+: Qwen2B (~6GB)
Superpoderes para Dashcam de Tesla
¿Tienes grabaciones del Modo Centinela de Tesla? SentrySearch extrae telemetría incrustada y quema superposiciones HUD:
sentrysearch search "coche cortándome el paso" --overlay
Muestra velocidad, ubicación GPS, marca de tiempo, incluso nombres de calles con geocodificación inversa.
💰 Optimización de Costes
- Salto de fotogramas estáticos: Omite automáticamente grabaciones de coche aparcado
- Preprocesamiento: Reducción del 95% del tamaño (480p@5fps segmentos)
- Segmentos ajustables:
--chunk-duration 60 --overlap 5reduce a la mitad los costes de API
1 hora de indexación = ~$2.84 (3.600 fotogramas × $0.00079)
🛠️ Funciones Pro
# Guardar top 5 coincidencias
sentrysearch search "peatón" --save-top 5
# Umbral de confianza personalizado
sentrysearch search "evento" --threshold 0.7
# Gestionar índice
sentrysearch stats
sentrysearch remove old_footage/
sentrysearch reset
🎯 Casos de Uso
- Propietarios de Tesla: Analizar incidentes del Modo Centinela
- Equipos de seguridad: Buscar en grabaciones de vigilancia
- Creadores de contenido: Encontrar clips específicos en grabaciones crudas
- Investigadores: Consultar patrones de comportamiento en conjuntos de datos de video
- Cualquiera con grabaciones de dashcam/cámara de acción
📦 Compatible Con
✅ Archivos MP4, MOV ✅ Firmware Tesla 2025.44.25+ (HW3+) ✅ Dashcams normales, videos de teléfono, cámaras de seguridad ✅ Python 3.11+, ffmpeg (auto-incluido)
🚀 Por Qué SentrySearch Gana
- 2.6K estrellas en GitHub, probado en batalla
- Licencia MIT, listo para producción
- Búsqueda en subsegundo incluso en horas de grabaciones
- Backend dual (nube + local)
- Recorte automático, sin post-procesamiento
- Optimizaciones conscientes de costes integradas
Deja de avanzar rápido por las grabaciones. Empieza a buscar.