K-NagaCharan/APES

¿Qué hace APES?

Sistema de gestión de fotos potenciado por IA con reconocimiento facial automatizado (InsightFace), asistentes conversacionales basados en LLM (Groq) y uso compartido automatizado (WhatsApp y correo electrónico).

Descripción General

APES integra tecnologías de vanguardia para ofrecer una solución completa de gestión de fotografías. Con InsightFace, el sistema identifica y etiqueta automáticamente rostros en las imágenes, lo que permite organizar álbumes por personas. El módulo conversacional basado en Groq permite a los usuarios interactuar con el sistema mediante lenguaje natural para buscar fotos, obtener resúmenes o iniciar procesos de compartición.

Características Clave

• Reconocimiento Facial Automatizado: Utiliza modelos preentrenados de InsightFace para detectar y reconocer rostros con alta precisión.
• Asistente Conversacional LLM: Integra Groq para comprender y responder consultas en lenguaje natural, facilitando la interacción con el sistema.
• Uso Compartido Automatizado: Permite enviar fotos automáticamente a través de WhatsApp y correo electrónico a contactos predefinidos.
• Organización Inteligente: Clasifica y etiqueta imágenes basándose en metadatos, reconocimiento facial y contexto conversacional.

Plataformas Soportadas

Este skill está diseñado para funcionar con agentes de IA como Claude Code, Cursor y Codex, así como en entornos de desarrollo personalizados.

Configuración e Instalación

Para utilizar APES, sigue estos pasos:

1. Clona el repositorio:

   git clone https://github.com/K-NagaCharan/APES.git
   cd APES
   

2. Instala las dependencias requeridas:

   pip install -r requirements.txt
   

3. Configura las variables de entorno necesarias:

   • GROQ_API_KEY: Tu clave de API para Groq.
   • WHATSAPP_API_TOKEN: Token para la API de WhatsApp (si se usa).
   • EMAIL_SMTP_CONFIG: Configuración SMTP para el envío de correos electrónicos.

4. Ejecuta la aplicación:

   python main.py
   

Uso

Una vez en funcionamiento, puedes interactuar con APES mediante comandos conversacionales. Por ejemplo:

• "Organiza mis fotos por rostros"
• "Encuentra todas las fotos de Juan"
• "Comparte las fotos del evento con María por WhatsApp"

Estructura del Proyecto

APES/
├── main.py                 # Punto de entrada de la aplicación
├── config.py               # Configuración y variables de entorno
├── requirements.txt        # Dependencias del proyecto
├── modules/
│   ├── face_recognition.py # Módulo de reconocimiento facial (InsightFace)
│   ├── llm_assistant.py    # Módulo de asistente conversacional (Groq)
│   ├── sharing.py          # Módulo de compartición (WhatsApp, Email)
│   └── utils.py            # Utilidades varias
├── data/
│   └── photos/             # Directorio para las fotos de entrada
└── output/
    └── albums/             # Directorio para los álbumes generados

Contribuciones

Las contribuciones son bienvenidas. Por favor, abre un issue o envía un pull request para proponer mejoras o reportar errores.

Licencia

Este proyecto está bajo la licencia MIT. Consulta el archivo LICENSE para más detalles.