Aplicación gráfica moderna de gestión de correos electrónicos y calendario unificado, desarrollada en Python con FastAPI y potenciada con el SDK oficial de Google Gemini AI (google-genai), siguiendo las directrices de diseño del estándar 02-admin-apps.
-
Conectividad Multi-Cuenta & Firmas:
- Google Gmail (OAuth 2.0 en 1 Clic): Abre una ventana web oficial de Google donde autorizas la cuenta directamente sin contraseñas técnicas, sincronizando mediante la Gmail REST API oficial.
- ProtonMail: Integración directa con Proton Mail Bridge local (
127.0.0.1:1143IMAP /127.0.0.1:1025SMTP). - Personalización de Color por Cuenta: Elige el color del indicativo visual de cada cuenta con selector libre y presets (rojo, morado, azul, verde, ámbar, rosa, cian). Cada correo en la bandeja muestra el color distintivo de su cuenta.
- Edición y Prueba de Conexión: Edita cualquier cuenta guardada y verifica en tiempo real la conexión IMAP y SMTP con diagnóstico de errores.
- Gestor de Firmas Inteligente: Crea múltiples firmas personalizadas, asigna una predeterminada por cuenta con inyección automática al redactar.
-
Inteligencia Artificial & Agentes Autónomos con Google Antigravity SDK (
google-antigravity):- Antigravity Copilot (Agente Autónomo): Panel lateral de chat interactivo con un agente con capacidad de ejecución de herramientas (Tool Calling):
buscar_correos: Búsqueda profunda en tu buzón por cualquier palabra clave, asunto o remitente.leer_correo: Inspección de contenido completo y análisis contextual.agendar_evento_calendario: Agendamiento autónomo de citas en el calendario unificado de Google/Proton.listar_proximos_eventos: Consulta instantánea de compromisos agendados.
- Área de Prompt para Redacción: Escribe órdenes en lenguaje natural, ajusta el tono (formal, cordial, conciso, comercial) y transfiere el borrador generado directamente al redactor.
- Depuración de Correos por Prompt (Mail Cleanup AI): Limpieza de buzones mediante instrucciones como "localiza newsletters y promociones de más de 30 días", con previsualización detallada y justificación de selección antes de actuar.
- Resumen Ejecutivo (TL;DR): Resúmenes de correos, puntos clave y nivel de urgencia.
- Smart Reply: Respuestas contextuales instantáneas.
- Antigravity Copilot (Agente Autónomo): Panel lateral de chat interactivo con un agente con capacidad de ejecución de herramientas (Tool Calling):
-
Calendario Unificado (Google + Proton):
- Vista mensual interactiva y lista de agenda próxima.
- Código de colores por proveedor (Google Calendar en azul, Proton Calendar en morado).
- Programación, edición y eliminación de eventos.
ProtonMail cifra todos los mensajes con llaves PGP de extremo a extremo y no dispone de servidores IMAP/SMTP abiertos en la nube.
Para sincronizar con MerkeMail:
- Abre tu aplicación Proton Mail Bridge en tu equipo.
- Copia la contraseña y puertos generados por el Bridge (
127.0.0.1:1143para IMAP y127.0.0.1:1025para SMTP). - En MerkeMail ve a Cuentas Conectadas > Configurar ProtonMail Bridge / IMAP Manual, selecciona el preset de Proton y pulsa Guardar Cuenta.
- Diseño de Interfaz (Estándar 02-admin-apps):
- Modo Dual: Soporte completo para
Light ModeyDark Mode(dark:bg-slate-950ydark:bg-slate-900). - Sidebar persistente con el logotipo oficial
merke.svg/merke.png. - Data Table con densidad compacta (
text-sm,py-3), buscador en tiempo real y paginación en el pie. - Modales Laterales (Slide-over Drawers): Para búsqueda avanzada, redacción IA, depuración por prompt y ajustes de API Keys.
- Notificaciones Sticky: Avisos flotantes temporizados para confirmaciones de guardado y actualización.
- Modales de Confirmación: Reemplazo integral y seguro de
alert()yconfirm()nativos para acciones destructivas.
- Modo Dual: Soporte completo para
Para iniciar la aplicación:
# Activar entorno virtual
source .venv/bin/activate
# Iniciar servidor y abrir en el navegador
./run.py
# o
python3 run.pyLa aplicación estará disponible en: http://127.0.0.1:8000
- Haz clic en Ajustes & Gemini Key en la barra inferior del sidebar lateral.
- Pega tu API Key de Google AI Studio.
- Haz clic en Probar Conexión para verificar el estado en tiempo real.
- Selecciona tu modelo favorito (
gemini-2.5-flashogemini-2.5-pro) y pulsa Guardar Cambios.
Este proyecto está licenciado bajo la Business Source License 1.1 (BSL 1.1). Consulta el archivo LICENSE para conocer los términos completos y las concesiones de uso. En la fecha de cambio (Change Date), el código transiciona automáticamente a GNU General Public License v2.0 or later (GPL-2.0-or-later).
