Email Assistant
Professional email management system with AI-powered categorization, daily digests, and comprehensive observability.
What It Does
The AI Email Executive Assistant helps manage your inbox by:
- Categorizing emails intelligently using Gemini AI
- Generating daily digests with consolidated summaries
- Tracking metrics for email processing and API usage
- Providing observability through a beautiful web dashboard
Key Features
Core Capabilities
- ✅ Gmail Integration with OAuth 2.0
- ✅ AI Categorization using Gemini 2.5 Flash Lite
- ✅ Daily Digest with newsletter highlights
- ✅ Beautiful responsive web interface
- ✅ LRU caching (30 emails, 24h expiry)
- ✅ Comprehensive metrics tracking with SQLite
- ✅ Graceful error handling with detailed logging
- ✅ JSON-based configuration
Email Categories
| Category | Description |
|---|---|
| Need-Action | Emails requiring your response |
| FYI | Informational, no action needed |
| Newsletter | Subscriptions and updates |
| Promotional | Marketing and offers |
| Social | Social network notifications |
Architecture Preview
Screenshots
| Digest View | Metrics Dashboard |
|---|---|
| Daily email summary with categories | API usage and performance tracking |
Tracked Metrics
The system tracks 12+ comprehensive metrics:
- Total Emails Processed
- Cache Hit Rate
- API Calls Made
- Average Execution Time
- Emails by Category
- Success Rate
- Script Run Count
- Error Count
- Average API Response Time
- Estimated API Cost
- Cache Utilization
- Recent Errors
Quick Links
Version Info
| Property | Value |
|---|---|
| Version | 2.1 |
| Python | 3.14+ |
| Status | Production Ready ✅ |
| Tests | 55+ tests |