immich-family-tools
Herramienta web para gestión de reconocimiento facial cruzado entre múltiples cuentas de Immich auto-hospedadas, sincronizando nombres y álbumes compartidos sin modificar la instalación base.
Ficha actualizada 22 sept 2026, 15:35 · upstream 22 sept 2026, 13:30 · release v1.7.0
Qué es immich-family-tools
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Immich Family Tools es una aplicación complementaria diseñada para instancias de Immich con múltiples cuentas de usuario. Resuelve el problema de que el reconocimiento facial no se comparte entre cuentas: cada cuenta construye su propia base de datos independiente de personas, aunque el 90% de las caras correspondan a las mismas personas.
La herramienta funciona mediante la API REST de Immich sin tocar la instalación existente. Utiliza FastAPI en Python para el backend y React con TypeScript para el frontend. No requiere base de datos persistente — todos los datos se cargan en vivo desde la API de Immich, solo persistiendo claves de API, coincidencias descartadas, álbumes gestionados y registro de sincronización en accounts.json.
El sistema combina dos señales principales: similitud de nombres (distancia de Levenshtein) hasta 75% de peso, y embeddings faciales cuando están disponibles (hasta 25%). En Immich v3.1 los embeddings ya no se exponen, por lo que la coincidencia depende principalmente del nombre. Soporta TrueNAS Scale con configuraciones ZFS POSIX ACLs.
- Gestionar reconocimiento facial familiar en múltiples cuentas de Immich sin duplicar bases de datos
- Sincronizar nombres canónicos entre personas idénticas detectadas en diferentes cuentas
- Crear álbumes compartidos con fotos de una misma persona desde varias cuentas
- Añadir nuevos miembros familiares a álbumes existentes mediante Match erweitern
- Auditar y deshacer acciones de sincronización mediante el panel de registro completo
- No requiere base de datos — persistencia mínima en accounts.json (claves API, log de sincronización)
- Soporta despliegue TrueNAS Scale con ZFS POSIX ACLs preconfigurados
- Multi-idioma: DE, EN, ES, PT-BR con persistencia en localStorage
- API keys granulares documentadas con 16 permisos específicos para cada funcionalidad
- Cache de miniaturas LRU de 50 MB y caché de coincidencias de 5 minutos
- Licencia MIT — código abierto sin restricciones comerciales
- Solo compatible con Immich v3.x (v2 o anteriores no soportados desde v1.3.0)
- Coincidencias automáticas limitadas a personas con nombre — personas sin nombre requieren matching manual
- En Immich v3.1 los embeddings faciales no se exponen, reduciendo precisión a ~75% en coincidencias por nombre
- Requiere claves API para cada cuenta de Immich con 16 permisos específicos habilitados
- No incluye gestión de usuarios — solo token compartido IMMICH_FAMILY_TOOLS_SECRET
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.
Docker + Docker Compose. Clonar repositorio, copiar .env.example a .env (configurar IMMICH_FAMILY_TOOLS_SECRET con token aleatorio). Ejecutar docker compose up -d --build. Abrir http://localhost:3100 y añadir cuentas Immich. Para TrueNAS Scale: crear datasets ZFS con acltype=posix antes del primer arranque, establecer UID/GID 3006 para ownership. Requiere Immich v3.x con claves API habilitadas.
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.