file-hunter
Gestor de archivos auto-alojado que cataloga, deduplica y consolida almacenamiento. Persiste metadatos en SQLite incluso con medios desconectados. Usa Python 3.10+, Starlette, uvicorn y frontend vanilla. Sin dependencias de framework.
Ficha actualizada 22 sept 2026, 13:49 · upstream 22 sept 2026, 13:31 · release v1.4.4
Qué es file-hunter
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
File Hunter es un gestor de archivos web auto-alojado diseñado para catalogar, deduplicar y consolidar almacenamiento local y externo. Utiliza una base de datos SQLite en modo WAL para persistir metadatos incluso cuando los medios se desconectan, permitiendo búsquedas y navegación sin acceso físico a los dispositivos.
El sistema emplea un algoritmo de hashing en tres etapas (xxHash64 parcial y completo) para identificar archivos duplicados con mínimo I/O, complementable con SHA-256 para verificación absoluta. Incluye consolidación segura con trazabilidad completa mediante metadatos .sources y .moved, operaciones de fusión de carpetas con preview, y gestión completa de archivos con soporte multi-usuario.
La interfaz web es responsive, funciona en servidores headless sin entorno de escritorio, soporta navegación por teclado, temas personalizables y actualizaciones en tiempo real vía WebSocket. No requiere frameworks frontend ni build steps, todo contenido se mantiene localmente sin servicios en la nube.
- Gestión de archivos en servidores headless desde cualquier navegador
- Catalogación de medios externos para fotógrafos y videógrafos con múltiples discos
- Auditoría de uso de almacenamiento en backups y medios de archivo
- Deduplicación de archivos a gran escala con trazabilidad completa
- Consolidación segura de copias con verificación hash y metadatos de procedencia
- Persistencia de catálogo offline con SQLite en modo WAL, sobreviviendo desconexión de medios
- Detección de duplicados mediante hashing xxHash64 optimizado (pre-filter + partial + full)
- Soporte multi-usuario con autenticación token-based y hashing PBKDF2
- Interfaz web responsive sin entorno de escritorio, navegación completa por teclado
- Búsqueda avanzada con consultas complejas, filtros múltiples y guardado de búsquedas
- No incluye Docker nativo; requiere contenedorización manual o usar fork dockerizado externo
- Base de datos SQLite puede tener límites de concurrencia en entornos multi-usuario intensivos
- Dependencia estricta de Python 3.10+ con virtual environment incluido en instalación
- No soporta archivos encriptados directamente; requiere acceso a contenido cifrado para hashing
- La versión Pro necesita agente externo separado para soporte remoto entre máquinas
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 con curl o descargar manualmente desde releases. Ejecutar ./filehunter tras extraer. Configurar autenticación inicial en wizard. Añadir locations vía interfaz web. Para Docker usar fork https://github.com/ikidd/file-hunter-dockerized. Mover carpeta de instalación mantiene funcionalidad completa.
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.