gmail-contact-graph
Herramienta para visualizar redes de comunicación de Gmail y Google Calendar mediante grafos interactivos en el navegador local. Usa parsers en Rust y una webapp en Next.js para analizar exportaciones Takeout sin subir datos a la nube.
Ficha actualizada 28 sept 2026, 11:15 · upstream 28 sept 2026, 11:09 · release v0.2.2
Qué es gmail-contact-graph
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este proyecto permite explorar visualmente las conexiones entre contactos y asistentes a eventos extraídos de tus exportaciones de Google Takeout (mbox e ics). La aplicación funciona completamente local, ejecutándose sobre un servidor web que solo se vincula a localhost para garantizar la privacidad. Los parsers están implementados en Rust para eficiencia, mientras que la interfaz gráfica utiliza Next.js y D3.js para renderizar el grafo de fuerzas interactivamente.
La configuración requiere entornos de desarrollo específicos, como Rust 1.87+ y Node.js 20.19+, además de dependencias de sistema como OpenSSL headers en Linux. Existe una opción opt-in para enviar nombres y correos a la API de Hugging Face mediante HF_API_KEY para filtrar spam automatizado, pero esto es opcional y no se realiza por defecto. El proyecto incluye soporte nativo para Docker Compose para simplificar el despliegue sin necesidad de compilar manualmente las dependencias del sistema.
- Visualizar la frecuencia de comunicación con contactos específicos en Gmail
- Identificar redes sociales o profesionales a través de asistentes compartidos en eventos de Google Calendar
- Analizar patrones de comunicación personal manteniendo los datos en el dispositivo local
- Filtrar automáticamente correos no deseados usando clasificación de IA opcional vía Hugging Face
- Privacidad total por defecto: todo el procesamiento se realiza localmente sin subir datos a servidores externos
- Parsers en Rust: implementación eficiente y segura para procesar archivos mbox e ics grandes
- Interfaz interactiva D3.js: visualización de grafos de fuerzas para explorar conexiones complejas fácilmente
- Soporte Docker Compose: despliegue simplificado con una sola línea de comando sin necesidad de instalaciones manuales
- Dependencias de sistema complejas: requiere Rust, Node.js y headers OpenSSL en Linux que pueden ser difíciles de instalar
- Procesamiento local: no permite análisis en la nube ni acceso remoto directo sin configurar un proxy o servidor inverso
- Formato de entrada limitado: solo acepta exportaciones Takeout (.mbox y .ics), no correos en tiempo real
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.
Clona el repositorio, ejecuta 'make setup' para instalar dependencias y 'make run' para iniciar la webapp en localhost:5000. Alternativamente, usa 'docker compose up -d webapp' si prefieres contenedores. Asegúrate de tener los archivos .mbox y .ics en las carpetas data/Email/ y data/Calendar/. No olvides configurar HF_API_KEY solo si deseas activar el filtro de spam automatizado.
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.