Damien Email Wrestler

Uma plataforma de inteligência de e-mail com tecnologia de IA que se integra ao Gmail e ao OpenAI. Pode ser executada como uma ferramenta CLI ou implantada no AWS Lambda para capacidades aprimoradas.

GitHub

Experimente este MCPPatrocinado

Documentação

🤼‍♂️ Damien Email Wrestler

A Plataforma de Inteligência de E-mail com IA

O Damien Email Wrestler é uma plataforma de inteligência de e-mail com IA de nível empresarial que transforma a forma como você gerencia e-mails por meio de assistentes de IA em linguagem natural, como o Claude. Construído com arquitetura híbrida de CLI + AWS Lambda, inteligência artificial avançada, otimização de custos e integração MCP perfeita.

✨ Status Atual: Workflow de Desenvolvimento Profissional v0.5.0 🎉

🏆 Plataforma Completa de Inteligência de E-mail com Workflow Profissional no GitHub

49 Ferramentas Otimizadas: Suíte aprimorada de gerenciamento de e-mail com organização em linguagem natural, limpeza inteligente e polling automático
✅ WORKFLOW PROFISSIONAL COMPLETO: Automação no GitHub, templates de issues, validação de PRs e rotulagem automatizada
✅ WORKFLOW APRIMORADO VALIDADO: 282 e-mails de marketing processados com 100% de precisão em testes de produção
Arquitetura Híbrida: Confiabilidade do CLI + aprimoramento de IA via AWS Lambda quando configurado
Testado no Mundo Real: 100-500 e-mails analisados com 83-86% de confiança na detecção de padrões
Segmentação de Precisão: Análise de IA → IDs de e-mail → Operações em lote precisas (zero falsos positivos)
Design Focado em Privacidade: Armazenamento apenas de metadados com limpeza automática por TTL (30-90 dias)
Custo-Efetivo: $0,01 por análise de 100 e-mails, ~$1/mês para usuário único
Nível Empresarial: Proteção de privacidade, arquitetura escalável, fallback gracioso

🚀 O Que Torna o Damien Especial

Gerenciamento de E-mail em Linguagem Natural: "Crie uma regra para arquivar newsletters" → Feito automaticamente
Processamento de IA Híbrido: Confiabilidade do CLI + aprimoramento via AWS Lambda para análise de nível empresarial
Validado no Mundo Real: 83% de cobertura de automação com 92% de confiança na detecção de padrões
Arquitetura Focada em Privacidade: Armazenamento apenas de metadados, zero exposição de conteúdo de e-mail
Custo Otimizado: $0,01 por análise de 100 e-mails com AWS Lambda pay-per-request
Escalabilidade Empresarial: Lida com conjuntos de dados de 66k+ e-mails com processamento em lote inteligente
Inteligência em Tempo Real: 14,49 segundos para análise de 100 e-mails com aprimoramento Lambda

🎯 Capacidades Principais

🧠 Suíte de Inteligência de IA

📊 Análise de E-mail: Detecta padrões, sentimento e impacto nos negócios em milhares de e-mails
🤖 Automação Inteligente: Criação de regras em linguagem natural — "Arquive e-mails de newsletters"
💡 Insights Inteligentes: Análise de tendências, métricas de eficiência e recomendações de otimização
⚡ Otimização de Caixa de Entrada: Estratégias de organização e limpeza com IA
🔍 Busca Avançada: Busca semântica com compreensão de contexto aprimorada por RAG

📧 Gerenciamento Completo de E-mail

Gerenciamento de Threads: Operações em nível de conversa com contexto completo
Ciclo de Vida de Rascunhos: Crie, edite, envie e gerencie rascunhos sem interrupções
Operações em Lote: Processe milhares de e-mails com eficiência e acompanhamento de progresso
Filtragem Inteligente: Automação sofisticada baseada em regras com aprimoramento de ML
Gerenciamento de Rótulos: Categorização e organização inteligentes

🛡️ Recursos Empresariais

Proteção de Privacidade: Detecção de PII com 99,9% de precisão e tokenização reversível
Monitoramento de Custos: Rastreamento de uso de tokens em tempo real com alertas configuráveis
Otimização de Desempenho: Roteamento inteligente de modelos (gpt-4o-mini vs gpt-4o)
Conformidade de Auditoria: Pronto para GDPR/CCPA/HIPAA com trilhas de auditoria imutáveis
Arquitetura Escalável: Lide com cargas de trabalho empresariais com processamento em lote inteligente

🏗️ Visão Geral da Arquitetura Híbrida

O Damien Email Wrestler é composto por componentes integrados com processamento híbrido de CLI + AWS Lambda:

┌─────────────────┐    ┌─────────────────────┐    ┌──────────────────┐    ┌─────────────┐
│                 │    │                     │    │                  │    │             │
│   AI Assistant  │◄──►│  Smithery Adapter   │◄──►│   Damien MCP     │◄──►│ Gmail API   │
│    (Claude)     │    │   (Port 8081)       │    │   Server         │    │             │
│                 │    │                     │    │   (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    │
                                               └──────────────────────────┘

Detalhamento dos Componentes

🤖 Servidor MCP Damien (Porta 8892)

49 Ferramentas MCP Otimizadas: Suíte focada de gerenciamento de e-mail com capacidades de polling automático
Processamento Híbrido: Análise CLI padrão + aprimoramento de IA via AWS Lambda (quando configurado)
Fallback Gracioso: Funcionalidade completa sem AWS — o Lambda aprimora, mas nunca é obrigatório
Backend FastAPI: API assíncrona de alto desempenho com monitoramento abrangente
Segurança Empresarial: OAuth 2.0, limitação de taxa, registro de auditoria

🔗 Adaptador Smithery (Porta 8081)

Ponte de Protocolo MCP: Integração perfeita com assistentes de IA
Descoberta de Ferramentas: Registro dinâmico de ferramentas e anúncio de capacidades
Tratamento de Erros: Fallbacks graciosos e mecanismos de nova tentativa
Otimização de Desempenho: Pooling de conexões e cache

🧠 Camada de Inteligência de IA Híbrida

Processamento Padrão: Análise baseada em CLI sempre disponível com detecção de padrões
Aprimoramento Lambda: Classificação de IA de nível empresarial quando as credenciais AWS estão configuradas
Guardião de Privacidade: Proteção de PII e tokenização de nível empresarial
Roteador de Inteligência: Seleção de modelos com ML para otimização de custos
Mecanismo RAG: Busca semântica com embeddings vetoriais para compreensão contextual
Processador em Lote: Processamento escalável de grandes volumes de e-mail com acompanhamento de progresso

☁️ Camada de Aprimoramento AWS Lambda

Processador de E-mail: Extração e armazenamento de metadados com segurança de privacidade
Analisador de IA: Classificação de e-mail de alta confiança (precisão de 85%+)
Mecanismo de Regras: Execução inteligente de regras com resolução de conflitos
Armazenamento DynamoDB: Armazenamento apenas de metadados com limpeza automática por TTL (30-90 dias)
Otimização de Custos: Modelo pay-per-request (~$1/mês para usuário único)

🚀 Início Rápido

Pré-requisitos

Python 3.11+ com Poetry
Node.js 18+ com npm
Credenciais da API Gmail (Guia de Configuração)
Chave da API OpenAI (para recursos de IA)
Credenciais AWS (opcional — para aprimoramento Lambda) (Guia de Configuração)

1. Instalação (2 minutos)

# Clone repository
git clone https://github.com/your-org/damien-email-wrestler.git
cd damien-email-wrestler

# Configure environment
cp .env.example .env
# Add your Gmail credentials and OpenAI API key to .env

# Install dependencies
cd damien-cli && poetry install && cd ..
cd damien-mcp-server && poetry install && cd ..
cd damien-smithery-adapter && npm install && cd ..

2. Iniciar Serviços (30 segundos)

# Start all services with one command
./scripts/start-all.sh

Saída Esperada: ✅ Todos os serviços em execução com verificações de saúde aprovadas

3. Conectar o Claude Desktop (2 minutos)

Adicione ao seu ~/.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. Testar Integração (1 minuto)

# Authenticate with Gmail
cd damien-cli && poetry run damien login

# Run validation tests
cd .. && ./run_e2e_tests.sh

🎉 Você está pronto! Experimente no Claude Desktop: "Liste meus e-mails recentes e sugira 3 regras de automação"

💡 Exemplos de Uso

Gerenciamento de E-mail em Linguagem Natural

You: "Analyze my emails from the last week and find patterns"
Claude: [Uses damien_ai_analyze_emails] Found 3 key patterns:
• 15 newsletter emails (suggest auto-archive rule)
• 8 meeting requests (suggest calendar integration)  
• 12 customer support emails (suggest priority labeling)

You: "Create a rule to automatically archive newsletters"
Claude: [Uses damien_ai_create_rule] Created rule with 95% confidence:
✅ Auto-archive emails containing "unsubscribe" from marketing domains

You: "Optimize my inbox for better productivity"  
Claude: [Uses damien_ai_optimize_inbox] Completed optimization:
• Archived 47 old newsletters
• Labeled 23 emails as "Action Required"
• Created 3 smart filters for automatic organization

Operações Avançadas de E-mail

# CLI Usage
poetry run damien emails list --query "from:boss@company.com" --max-results 10
poetry run damien ai analyze-emails --days 30 --min-confidence 0.8
poetry run damien rules suggest --categories "productivity,automation"

# Bulk Operations  
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

📊 Desempenho e Otimização de Custos

Eficiência de Custos

Roteamento Inteligente de Modelos: Usa automaticamente o gpt-4o-mini (90% mais barato) para tarefas simples
AWS Lambda: Modelo pay-per-request com escalonamento automático
Otimização de Tokens: O parâmetro include_headers reduz chamadas de API em 80%+
Otimização de Consultas: Segmentação inteligente de categorias específicas de e-mail
Monitoramento em Tempo Real: Acompanhe custos com alertas configuráveis
Custos Reais: $0,01 para análise de 100 e-mails, ~$1/mês para usuário único

Métricas de Desempenho (Testado no Mundo Real)

Análise de E-mail: 100 e-mails em 14,49 segundos (6,9 e-mails/segundo) ✅
✅ WORKFLOW APRIMORADO: 282 e-mails de marketing segmentados com precisão e movidos para a lixeira em testes de 100/200/500 e-mails ✅
Segmentação de Precisão: 100% de precisão — todo e-mail identificado pela IA foi processado com sucesso ✅
Detecção de Padrões: 83-86% de confiança na classificação de newsletters/promocionais com validação estatística ✅
Processamento Escalável: Manipulação perfeita de 100-500 e-mails com workflow assíncrono ✅
Aprimoramento Lambda: Precisão de 85%+ para classificação de alta confiança ✅
Processamento Lambda: Menos de 300ms por chamada de função ✅
Resposta da API Gmail: < 2 segundos ✅
Execução de Ferramentas MCP: < 5 segundos por operação ✅
Uso de Memória: < 1GB durante operação normal ✅

Escalabilidade

Processamento em Lote: Lide com 100K+ e-mails com divisão inteligente em blocos
Operações Progressivas: Feedback em tempo real para tarefas de longa duração
Operações Paralelas: Processamento multithread com acompanhamento de progresso
Gerenciamento de Recursos: Limpeza automática e coleta de lixo
Saúde do Serviço: Monitoramento abrangente com reinicializações automáticas

🛡️ Segurança e Privacidade

Proteção de Privacidade

Armazenamento Apenas de Metadados: Nenhum conteúdo de e-mail é armazenado, apenas metadados seguros
Privacidade AWS Lambda: Processamento em nuvem com zero exposição de conteúdo
Expiração Automática de Dados: Limpeza baseada em TTL (30-90 dias)
Detecção de PII com 99,9%: Reconhecimento avançado de padrões para dados sensíveis
Tokenização Reversível: Processamento seguro mantendo a recuperabilidade
Trilhas de Auditoria: Registro imutável para conformidade e depuração

Conformidade Empresarial

Pronto para GDPR: Gerenciamento de consentimento de processamento de dados e direito à exclusão
Em conformidade com CCPA: Conformidade com a lei de privacidade da Califórnia integrada
Considerações HIPAA: Padrões de proteção de dados de saúde
Controle de Acesso: Permissões baseadas em funções e gerenciamento de chaves de API

Recursos de Segurança

OAuth 2.0: Autenticação padrão do setor com APIs do Google
Limitação de Taxa: Previne abuso e garante uso justo
Tratamento de Erros: Falhas graciosas sem expor dados sensíveis
Armazenamento Criptografado: Todas as credenciais e tokens armazenados com segurança

📚 Documentação

Guia de Início Rápido — Comece a usar em 15 minutos
Referência da API — Documentação completa das ferramentas
Solução de Problemas — Problemas comuns e soluções
Guia de Testes E2E — Checklist de validação de produção

🔧 Configuração Avançada

Variáveis de Ambiente

# AI Intelligence Configuration
AI_MODEL_STRATEGY="cost_optimized"          # cost_optimized | performance_optimized | balanced
USE_OPENAI_API=true                          # Use OpenAI API vs local models
TRACK_TOKEN_USAGE=true                       # Enable cost monitoring
COST_ALERT_THRESHOLD_USD=10.00               # Alert when costs exceed threshold

# Performance Tuning
MAX_TOKENS_PER_REQUEST=4000                  # Token limit per API call
SIMPLE_TASK_MAX_TOKENS=1000                  # Threshold for gpt-4o-mini usage
COMPLEX_TASK_MIN_CONFIDENCE=0.8              # Threshold for gpt-4o usage

# Privacy & Security
PII_DETECTION_ENABLED=true                   # Enable PII protection
AUDIT_LOGGING_ENABLED=true                   # Enable compliance logging
CONSENT_REQUIRED=false                       # Require explicit consent for processing

Gerenciamento de Serviços

# Start/Stop Services
./scripts/start-all.sh                       # Start all services
./scripts/stop-all.sh                        # Stop all 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               # Cost tracking logs

🏆 Por que Escolher o Damien?

🎯 Para Indivíduos

Economia de Tempo: Automatize 80% das tarefas rotineiras de e-mail
Inteligência: Insights e detecção de padrões com IA
Controle: Comandos em linguagem natural com controle preciso
Privacidade: Proteção de nível empresarial para e-mails pessoais

🏢 Para Equipes e Organizações

Escalabilidade: Lide com milhares de e-mails entre membros da equipe
Conformidade: Trilhas de auditoria integradas e proteção de privacidade
Eficiência de Custos: Uso otimizado de IA economiza 80% nos custos de API
Integração: Conexão perfeita com workflows existentes

🚀 Para Desenvolvedores

Protocolo MCP: Integração padrão com assistentes de IA
Extensível: 48 ferramentas com opções fáceis de personalização
Integração AWS: Funções Lambda serverless com armazenamento DynamoDB
Arquitetura Híbrida: Processamento CLI + Nuvem para desempenho ideal
Pronto para Empresas: Arquitetura e monitoramento de nível de produção

📈 Roadmap

Atual (v0.4.2) — ✅ Workflow Aprimorado Completo

✅ PROCESSAMENTO DE E-MAIL APRIMORADO: Implementação de 3 semanas do sistema de segmentação precisa de IDs de e-mail
✅ VALIDADO EM PRODUÇÃO: 282 e-mails de marketing processados com 100% de precisão em diferentes escalas de teste
✅ Cache Inteligente: Despejo LRU/LFU com otimização de TTL para operações repetidas
✅ Processamento de Jobs Assíncronos: Manipulação perfeita de grandes conjuntos de dados com acompanhamento de progresso em tempo real
✅ Suíte de ferramentas MCP aprimorada (48 ferramentas no total: 39 principais + 2 de lixeira aprimorada + 5 de organização + 2 de limpeza inteligente)
✅ Arquitetura híbrida de aprimoramento de IA com CLI + AWS Lambda
✅ Armazenamento apenas de metadados com foco em privacidade e limpeza por TTL
✅ Validação no mundo real: 100-500 e-mails com 83-86% de confiança na detecção de padrões
✅ Segmentação de precisão: Análise de IA → IDs de e-mail → Operações em lote precisas
✅ Custo-efetivo: $0,01 por análise de 100 e-mails
✅ Escalabilidade empresarial: Lida com conjuntos de dados de 66k+ e-mails
✅ Fallback gracioso: Funcionalidade completa sem dependência da AWS

Próximo Lançamento (v0.5.0) — Q1 2025

🔄 Recursos de colaboração em tempo real
🔄 Painel de análise avançada
🔄 Suporte a múltiplas contas Gmail
🔄 Treinamento personalizado de modelos de IA
🔄 Compatibilidade móvel aprimorada

Fase de Desenvolvimento (v0.6.0 - v0.9.x) - Q2-Q4 2025

📅 Suporte a múltiplos provedores (Outlook, Yahoo)
📅 Integração com Slack e Teams
📅 Automação avançada de fluxos de trabalho
📅 Gerenciamento preditivo de e-mails
📅 Console de administração empresarial
📅 Endurecimento e otimização de produção

Lançamento Público (v1.0.0) - Q1 2026

🚀 Primeiro lançamento público
🚀 Documentação e suporte completos
🚀 Pronto para implantação empresarial
🚀 Lançamento da comunidade e ecossistema

🤝 Suporte e Comunidade

Issues: Issues do GitHub
Documentação: Este repositório e guias vinculados
Discussões: Discussões do GitHub
Segurança: Envie um e-mail para security@damien-platform.com para problemas de segurança

📄 Licença

Sem Licença - veja LICENSE para detalhes.

🙏 Agradecimentos

Construído com:

Model Context Protocol (MCP) - padrão de integração de assistente de IA
Smithery - registro e descoberta de ferramentas MCP
FastAPI - framework web Python de alto desempenho
OpenAI - modelos de linguagem e embeddings de IA
Gmail API - integração de serviço de e-mail

Transforme sua experiência de e-mail com inteligência alimentada por IA. Bem-vindo ao futuro do gerenciamento de e-mails. 🚀