🤼‍♂️ Damien Email Wrestler

La plateforme d'intelligence de messagerie alimentée par l'IA

Damien Email Wrestler est une plateforme d'intelligence artificielle de niveau entreprise qui transforme la façon dont vous gérez vos emails grâce à des assistants d'intelligence artificielle en langage naturel comme Claude. Construite avec une architecture CLI hybride + AWS Lambda, une intelligence IA avancée, une optimisation des coûts et une intégration MCP transparente.

✨ S tatut actuel : Enhanced Workflow Complete v0.4.2 🎉

🏆 Plateforme complète d'intelligence AI pour l'email avec interface en langage naturel

• 48 Outils optimisés: Suite de gestion des emails améliorée avec une organisation en langage naturel et un nettoyage intelligent
• ✅ WORKFLOW AMÉLIORÉ VALIDÉ: 282 emails marketing traités avec une précision de 100 % sur l'ensemble des tests de production
• Architecture hybride: Fiabilité de la CLI + amélioration de l'IA AWS Lambda lorsqu'elle est configurée
• Test en conditions réelles: 100 à 500 e-mails analysés avec un taux de confiance de 83 à 86 % pour la détection des schémas
• Ciblage précis: Analyse AI → ID des courriels → Opérations en masse précises (zéro faux positif)
• Conception axée sur la protection de la vie privée: Stockage de métadonnées uniquement avec nettoyage automatique du TTL (30-90 jours)
• Rentabilité: 0,01 $ par analyse de 100 courriels, ~1 $/mois pour un seul utilisateur
• Qualité entreprise: Protection de la vie privée, architecture évolutive, repli gracieux

ce qui rend Damien spécial

• Gestion des emails en langage naturel: "Créer une règle pour archiver les newsletters" → Fait automatiquement
• Traitement hybride de l'IA: Fiabilité de la CLI + amélioration d'AWS Lambda pour une analyse de niveau entreprise
• Validé dans le monde réel: couverture d'automatisation de 83 % avec une détection de motifs de 92 % de confiance
• Architecture axée sur la protection de la vie privée: Stockage de métadonnées uniquement, aucune exposition du contenu des courriels
• Optimisation des coûts: 0,01 $ par analyse de 100 e-mails avec paiement à la demande sur AWS Lambda
• Évolutivité de l'entreprise: traitement d'ensembles de données d'e-mails de plus de 66 000 avec mise en lots intelligente
• Intelligence en temps réel: 14.49 secondes pour l'analyse de 100 courriels avec l'amélioration Lambda

🎯 Capacités de base

🧠 AI Intelligence Suite

• 📊Analyse des e-mails: Détecter les modèles, le sentiment et l'impact sur l'entreprise à travers des milliers d'e-mails
• 🤖 Automatisation intelligente: Création de règles en langage naturel - "Archiver les emails des newsletters"
• 💡 Intelligent Insights: Analyse des tendances, mesures d'efficacité et recommandations d'optimisation
• ⚡Optimisation de la boîte de réception: Stratégies de désencombrement et d'organisation alimentées par l'IA
• 🔍 Recherche avancée: Recherche sémantique avec compréhension du contexte améliorée par RAG

📧 Gestion complète des e-mails

• Gestion des fils de discussion: Opérations au niveau de la conversation avec un contexte complet
• Cycle de vie des brouillons: Créez, modifiez, envoyez et gérez les brouillons de manière transparente
• Opérations en masse: Traitement efficace de milliers d'e-mails avec suivi de la progression
• Filtrage intelligent: Automatisation sophistiquée basée sur des règles avec amélioration ML
• Gestion des étiquettes: Catégorisation et organisation intelligentes

🛡️ Caractéristiques de l'entreprise

• Protection de la vie privée: Détection précise des IIP à 99,9 % avec symbolisation réversible
• Contrôle des coûts: Suivi de l'utilisation des jetons en temps réel avec alertes configurables
• Optimisation des performances: Routage intelligent des modèles (gpt-4o-mini vs gpt-4o)
• Conformité à l'audit: Prêt pour GDPR/CCPA/HIPAA avec des pistes d'audit immuables
• Architecture évolutive: Prise en charge des charges de travail de l'entreprise grâce à une mise en lot intelligente

🏗️ Présentation de l'architecture hybride

Damien Email Wrestler se compose de composants intégrés avec un traitement hybride CLI + AWS Lambda :

┌─────────────────┐ ┌─────────────────────┐ ┌──────────────────┐ ┌─────────────┐ │ │ │ │ │ │ │ │ │ │ AI Assistant │◄──►│ Smithery Adapter   │◄──►│ Damien MCP │◄──►│ Gmail API │ (Claude) │ │ (Port 8081) │ │ Serveur │ │ │ │    │ │ │ (Port 8892) │ │ └─────────────────┘ └─────────────────────┘    └──────────────────┘ └─────────────┘ │ │ │ ▼ ▼ ┌─────────────────────┐
                       ┌─────────────────┐ │ Hybrid Processing │ │ │ │ Layer │ │ Smithery │ │ - Standard CLI │◄──────┐ │ Registry │ │ - Privacy Guard │ │
                       │ │ │ - Smart Router │ │ └─────────────────┘ │ - Batch Processor │ │ └─────────────────────┘ │ │ ▼ │ ┌──────────────────────────┐ │ │ AWS Lambda Enhancement │ │ │ (When Credentials Set)   │ │ │ - Email Processor │ │ │ - AI Analyzer (85%+) │ │ │ - Rule Engine │ │ └──────────────────────────┘ │ │ │ ▼ │ ┌──────────────────────────┐ │ │ Privacy-First Storage │ │ │ - Metadata Only │ │ │ - TTL Auto-Cleanup │──────┘ │ - DynamoDB Tables │ │ - No Content Storage │ └──────────────────────────┘

Répartition des composants

🤖 Damien MCP Server (Port 8892)

• 48 Outils MCP optimisés: Boîte à outils de gestion des courriels ciblée selon le principe de Pareto
• Traitement hybride: Analyse CLI standard + amélioration de l'IA AWS Lambda (lorsqu'elle est configurée)
• Repli gracieux (Graceful Fallback) : Fonctionnalité complète sans AWS - Lambda améliore mais n'est jamais nécessaire
• Backend FastAPI: API asynchrone haute performance avec surveillance complète
• Sécurité d'entreprise: OAuth 2.0, limitation de débit, journalisation d'audit

adaptateur Smithery (Port 8081)

• Pont de protocole MCP: Intégration transparente avec les assistants IA
• Découverte d'outils: Enregistrement dynamique des outils et annonce des capacités
• Gestion des erreurs: Mécanismes de retour en arrière et de réessai
• Optimisation des performances: Mise en commun et mise en cache des connexions

🧠 Couche d'intelligence artificielle hybride

• Traitement standard: Analyse basée sur la CLI toujours disponible avec détection de modèles
• Amélioration Lambda: Classification AI de niveau entreprise lorsque les informations d'identification AWS sont configurées
• Privacy Guardian: Protection des IIP et tokenisation de niveau entreprise
• Intelligence Router: Sélection de modèles basée sur le ML pour l'optimisation des coûts
• RAG Engine: Recherche sémantique avec intégration de vecteurs pour une compréhension contextuelle
• Batch Processor: Traitement évolutif de gros volumes d'e-mails avec suivi de la progression

☁️ Couche d'amélioration AWS Lambda

• Email Processor: Extraction et stockage de métadonnées à l'abri des regards indiscrets
• AI Analyzer: Classification des e-mails à haute fiabilité (85 %+ de précision)
• Moteur de règles: exécution intelligente des règles avec résolution des conflits
• Stockage DynamoDB: Stockage de métadonnées uniquement avec nettoyage automatique du TTL (30-90 jours)
• Optimisation des coûts: Modèle de paiement à la demande (~1$/mois pour un seul utilisateur)

démarrage rapide

Conditions préalables

• Python 3.11+ avec Poetry
• Node.js 18+ avec npm
• Identifiants API Gmail(Guide d'installation)
• Clé API OpenAI (pour les fonctionnalités d'IA)
• Informations d'identification AWS (facultatif - pour l'amélioration de Lambda)(Guide d'installation)

1. Installation (2 minutes)

# Cloner le dépôt git clone https://github.com/your-org/damien-email-wrestler.git cd damien-email-wrestler # Configurer l'environnement cp .env.example .env # Ajouter vos identifiants Gmail et votre clé API OpenAI à .env # Installer les dépendances cd damien-cli && poetry install && cd ... cd damien-mcp-server && poetry install && cd ... cd damien-smithery-adapter && npm install && cd ..

2. Démarrer les services (30 secondes)

# Démarrer tous les services avec une seule commande ./scripts/start-all.sh

Sortie attendue: ✅ Tous les services sont en cours d'exécution et les contrôles de santé sont passés

3. Connecter Claude Desktop (2 minutes)

Ajouter à votre ~/.claude/claude_desktop_config.json:

{ "mcpServers" : { "damien-email-wrestler" : { "command" : "node", "args" : ["./damien-smithery-adapter/dist/index.js"], "cwd" : "/path/to/damien-email-wrestler", "env" : {"DAMIEN_MCP_SERVER_URL" : "http://localhost:8892", "DAMIEN_MCP_SERVER_API_KEY" : "your-api-key-from-.env" } } } }

4. Test d'intégration (1 minute)

# Authentification avec Gmail cd damien-cli && poetry run damien login # Exécution des tests de validation cd .. && ./run_e2e_tests.sh

🎉 Vous êtes prêt ! Essayez dans Claude Desktop: "Lister mes courriels récents et proposer 3 règles d'automatisation"

💡 Exemples d'utilisation

Gestion des courriels en langage naturel

Vous : "Analyser mes emails de la semaine dernière et trouver des modèles" Claude : [Uses damien_ai_analyze_emails] A trouvé 3 modèles clés : - 15 emails de newsletter (suggère une règle d'archivage automatique) - 8 demandes de réunion (suggère une intégration au calendrier) - 12 emails de support client (suggère un étiquetage prioritaire) Vous : "Créer une règle pour archiver automatiquement les newsletters" Claude : [Utilise damien_ai_create_rule] Créé une règle avec 95% de confiance : ✅ Archiver automatiquement les courriels contenant "unsubscribe" des domaines marketing Vous : "Optimiser ma boîte de réception pour une meilleure productivité"  
Claude : [Uses damien_ai_optimize_inbox] Optimisation terminée : - Archivage de 47 anciens bulletins d'information - Étiquetage de 23 courriels comme "Action requise" - Création de 3 filtres intelligents pour l'organisation automatique

Opérations avancées sur les emails

# Utilisation CLI poetry run damien emails list --query "from:boss@company.com" --max-results 10 poetry run damien ai analysis-emails --days 30 --min-confidence 0.8 poetry run damien rules suggest --categories "productivity,automation" # Opérations en masse poetry run damien emails bulk-label --query "is:unread older_than:30d" --label "Archive" poetry run damien emails bulk-trash --query "category:promotions older_than:90d" --dry-run

📊 O ptimisation des performances et des coûts

Efficacité des coûts

• Modèle intelligent de routage: Utilise automatiquement gpt-4o-mini (90% moins cher) pour les tâches simples
• AWS Lambda: Modèle de paiement à la demande avec mise à l'échelle automatique
• Optimisation des jetons: le paramètre include_headers réduit les appels à l'API de plus de 80 %
• Optimisation des requêtes: Ciblage intelligent de catégories d'emails spécifiques
• Surveillance en temps réel: Suivi des coûts avec des alertes configurables
• Coûts réels: 0,01 $ pour l'analyse de 100 e-mails, ~1 $/mois pour un seul utilisateur

Mesures de performance (testées en conditions réelles)

• Analyse des courriels: 100 courriels en 14,49 secondes (6,9 courriels/seconde) ✅
• flux de travail amélioré: 282 emails marketing ciblés avec précision et mis à la poubelle sur 100/200/500 tests d'emails ✅
• Ciblage précis: 100% de précision - chaque email identifié par l'IA est traité avec succès ✅
• Détection de modèles: 83-86 % de confiance dans la classification des newsletters/promotions avec validation statistique ✅
• Traitement évolutif: Traitement transparent de 100 à 500 courriels avec un flux de travail asynchrone ✅
• Amélioration Lambda: 85%+ de précision pour la classification à haute confiance ✅
• Traitement Lambda: Moins de 300 ms par appel de fonction ✅
• Réponse à l'API Gmail: < 2 secondes ✅
• Exécution de l'outil MCP: < 5 secondes par opération ✅
• Utilisation de la mémoire: < 1 Go en fonctionnement normal ✅

Évolutivité

• Traitement par lots: Traitement de plus de 100 000 courriels avec un découpage intelligent
• Opérations progressives: Retour d'information en temps réel pour les tâches de longue durée
• Opérations parallèles: Traitement multithread avec suivi de la progression
• Gestion des ressources: Nettoyage automatique et collecte des déchets
• Santé des services: Surveillance complète avec redémarrage automatique

🛡️ Sécurité et confidentialité

Protection de la vie privée

• Stockage des métadonnées uniquement: Aucun contenu d'e-mail n'est stocké, seules les métadonnées sont protégées
• Confidentialité AWS Lambda: Traitement dans le nuage sans exposition du contenu
• Expiration automatique des données: Nettoyage basé sur le TTL (30 à 90 jours)
• 99.9 % de détection des IIP: Reconnaissance avancée des formes pour les données sensibles
• Tokenisation réversible: Traitement sécurisé tout en maintenant la possibilité de récupération
• Pistes d'audit: Journalisation immuable pour la conformité et le débogage

Conformité de l'entreprise

• Prêt pour le GDPR: Gestion du consentement au traitement des données et droit à l'effacement
• Conformité à la CCPA: Conformité à la loi californienne sur la protection de la vie privée intégrée
• Considérations relatives à l'HIPAA: Modèles de protection des données dans le secteur de la santé
• Contrôle d'accès: Autorisations basées sur les rôles et gestion des clés API

Fonctionnalités de sécurité

• OAuth 2.0: Authentification standard avec les API de Google
• Limitation du débit: Prévention des abus et garantie d'une utilisation équitable
• Gestion des erreurs: Défaillances gracieuses sans exposer les données sensibles
• Stockage crypté: Toutes les informations d'identification et les jetons sont stockés en toute sécurité

📚 Documentation

• Guide de démarrage rapide - Pour être opérationnel en 15 minutes
• Référence API - Documentation complète de l'outil
• Dépannage - Problèmes courants et solutions
• Guide de test E2E - Liste de contrôle pour la validation de la production

🔧 Configuration avancée

Variables d'environnement

# Configuration de l'intelligence artificielle AI_MODEL_STRATEGY="cost_optimized" # cost_optimized | performance_optimized | balanced USE_OPENAI_API=true # Utiliser l'API OpenAI par rapport aux modèles locaux TRACK_TOKEN_USAGE=true # Activer la surveillance des coûts COST_ALERT_THRESHOLD_USD=10.00 # Alerte lorsque les coûts dépassent le seuil # Performance Tuning MAX_TOKENS_PER_REQUEST=4000 # Limite de jetons par appel API SIMPLE_TASK_MAX_TOKENS=1000 # Seuil pour l'utilisation de gpt-4o-mini COMPLEX_TASK_MIN_CONFIDENCE=0.8 # Seuil d'utilisation de gpt-4o # Confidentialité et sécurité PII_DETECTION_ENABLED=true # Activer la protection des informations confidentielles AUDIT_LOGGING_ENABLED=true # Activer l'enregistrement de la conformité CONSENT_REQUIRED=false # Exiger un consentement explicite pour le traitement des données

Gestion des services

# Start/Stop Services ./scripts/start-all.sh # Démarrer tous les services ./scripts/stop-all.sh # Arrêter tous les services # Service Health curl http://localhost:8892/health # MCP Server health curl http://localhost:8081/health # Smithery Adapter health # Logs tail -f logs/damien-mcp-server.log # MCP Server logs tail -f logs/smithery-adapter.log # Adapter logs tail -f logs/token_usage.json # Logs de suivi des coûts

🏆 Pourquoi choisir Damien ?

🎯 Pour les particuliers

• Gain de temps: Automatiser 80% des tâches routinières de messagerie
• Intelligence: Des idées et une détection de modèles alimentées par l'IA
• Contrôle: Commandes en langage naturel avec un contrôle précis
• Confidentialité: Protection de niveau entreprise pour les courriels personnels

🏢 Pour les équipes et les organisations

• Évolutivité: Traiter des milliers de courriels parmi les membres d'une équipe
• Conformité: Pistes d'audit intégrées et protection de la vie privée
• Rentabilité: L'utilisation optimisée de l'IA permet d'économiser 80 % des coûts d'API
• Intégration: Connexion transparente avec les flux de travail existants

🚀 Pour les développeurs

• Protocole MCP: Intégration standard avec les assistants d'IA
• Extensible: 48 outils avec des options de personnalisation faciles
• Intégration AWS: Fonctions Lambda sans serveur avec stockage DynamoDB
• Architecture hybride: CLI + traitement dans le cloud pour des performances optimales
• Prêt pour l'entreprise: Architecture et surveillance de niveau production

feuille de route

Actuel (v0.4.2) - ✅ Enhanced Workflow Complete (flux de travail amélioré)

• ✅ ENHANCED EMAIL PROCESSING: mise en œuvre en 3 semaines d'un système de ciblage précis des identifiants d'email
• ✅ PRODUCTION VALIDÉE: 282 e-mails marketing traités avec une précision de 100 % sur l'ensemble des échelles de test
• mise en cache intelligente: éviction LRU/LFU avec optimisation TTL pour les opérations répétées
• traitement asynchrone des tâches: Traitement transparent de grands ensembles de données avec suivi de la progression en temps réel
• suite d'outils MCP améliorée (48 outils au total : 39 outils de base + 2 outils de corbeille améliorés + 5 outils d'organisation + 2 outils de nettoyage intelligents)
• ✅ Architecture hybride CLI + AWS Lambda pour l'amélioration de l'IA
• ✅ Stockage de métadonnées en priorité avec nettoyage TTL
• ✅ Validation dans le monde réel : 100-500 courriels avec 83-86% de confiance dans la détection de modèles
• ciblage précis : Analyse de l'IA → ID des emails → Opérations en masse précises
• ✅ Rentabilité : 0,01 $ pour l'analyse de 100 courriels
• évolutivité de l'entreprise : gère des ensembles de données d'emails de plus de 66k
• ✅ Reprise en douceur : Fonctionnalité complète sans dépendance à AWS

Prochaine version (v0.5.0) - T1 2025

• fonctionnalités de collaboration en temps réel
• tableau de bord analytique avancé
• 🔄 Prise en charge de Gmail multi-comptes
• 🔄 Formation de modèles d'IA personnalisés
• 🔄 Compatibilité mobile améliorée

Phase de développement (v0.6.0 - v0.9.x) - T2-T4 2025

• 📅 Prise en charge de plusieurs fournisseurs (Outlook, Yahoo)
• 📅 Intégration de Slack et Teams
• 📅 Automatisation avancée des flux de travail
• 📅 Gestion prédictive des courriels
• 📅 Console d'administration d'entreprise
• renforcement et optimisation de la production

Version publique (v1.0.0) - T1 2026

• 🚀 Première version publique
• 🚀 Documentation et support complets
• 🚀 Prêt pour le déploiement en entreprise
• 🚀 Lancement de la communauté et de l'écosystème

🤝 Support et communauté

• Questions: GitHub Issues
• Documentation: Ce dépôt et les guides liés
• Discussions: Discussions sur GitHub
• Sécurité: Courriel security@damien-platform.com pour les problèmes de sécurité

licence

Pas de licence - voir LICENCE pour plus de détails.

🙏 Remerciements

Construit avec :

• Model Context Protocol (MCP ) - norme d'intégration des assistants d'IA
• Smithery - Registre et découverte d'outils MCP
• FastAPI - Cadre web Python haute performance
• OpenAI - Modèles de langage et d'intégration de l'IA
• Gmail API - Intégration de services de messagerie

Transformez votre expérience de la messagerie électronique grâce à l'intelligence alimentée par l'IA. Bienvenue dans le futur de la gestion des emails. 🚀