PishakHome
PishakHome es un sistema ligero de monitorización de mascotas auto-alojado para Raspberry Pi que ofrece visualización en directo, detección de movimiento, grabación continua o por eventos y alertas vía Telegram. Funciona sin nube ni suscripciones, con panel web protegido por contraseña.
Ficha actualizada 29 sept 2026, 0:56 · upstream 28 sept 2026, 21:45 · release V1.0.0
Qué es PishakHome
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
PishakHome es una aplicación Python ligera diseñada específicamente para Raspberry Pi 3B+ que permite monitorizar mascotas mediante cámara USB. Utiliza FastAPI como framework backend y SQLite como base de datos local, sin dependencias de Docker ni contenedores.
El sistema ofrece visualización en directo mediante stream MJPEG nativo desde webcam USB sin transcoding, detección de movimiento basada en diferencia de frames (sin OpenCV), grabación con tres modos (apagado, por movimiento o 24/7) y soporte para compresión H.264 configurable. Incluye panel web completo para gestión de configuraciones, navegación de grabaciones, eventos del sistema y reinicio automático de cámara.
La arquitectura es modular con componentes separados para detección, grabación, notificaciones Telegram (con soporte proxy HTTP/SOCKS5), estadísticas de red, autenticación PBKDF2 con protección CSRF y gestión de sesiones. El diseño prioriza bajo consumo de RAM (~1 GB) y CPU, funcionamiento local sin internet obligatorio, y recuperación automática ante fallos de cámara.
- Monitorización en directo de mascotas desde cualquier dispositivo web
- Grabación automática de eventos por detección de movimiento con alertas
- Sistema de vigilancia doméstica ligera para Raspberry Pi sin nube
- Visualización de estado de red y sistema en tiempo real
- Gestión centralizada de grabaciones y configuraciones vía panel web
- Funciona sin internet ni servicios en la nube, todo local
- Panel web protegido con autenticación PBKDF2, CSRF y bloqueo por fuerza bruta
- Soporte nativo para proxy HTTP/SOCKS5 en alertas Telegram
- Recuperación automática de cámara con reinicio tras desconexión
- Tres modos de grabación flexibles (por evento o 24/7)
- Interfaz web responsive sin necesidad de archivos de configuración
- Requiere Raspberry Pi 3B+ o sistema Linux compatible con v4l-utils
- No incluye Docker ni contenedores, instalación manual obligatoria
- Detección de movimiento ligera sin OpenCV puede tener precisión limitada
- Grabación H.264 consume CPU adicional en hardware limitado
- Dependencia externa de ffmpeg para codificación de video
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Instalar Python 3.11+, ffmpeg y v4l-utils. Crear entorno virtual, activar dependencias y ejecutar con uvicorn en puerto 8000 o como servicio systemd. Cambiar credenciales por defecto inmediatamente. Asegurar permisos de grupo video para acceso a cámara USB.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.