Email Assistant
Professional email management system with AI-powered categorization, daily digests, and comprehensive observability through a beautiful web dashboard.
📦
Source Code
GitHub Repository
🌐
Web Dashboard
Flask + Responsive UI
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
OAuth 2.0 authentication with Gmail API
AI Categorization
Gemini 2.5 Flash Lite for intelligent sorting
Daily Digest
Newsletter highlights and email summaries
Metrics Dashboard
Comprehensive tracking with SQLite storage
LRU Caching
30 emails cached with 24h expiry
JSON Configuration
Flexible settings without code changes
Email Categories
| Category | Description |
|---|---|
| Need-Action | Emails requiring your response or action |
| FYI | Informational emails, no action needed |
| Newsletter | Subscriptions and periodic updates |
| Promotional | Marketing emails and offers |
| Social | Social network notifications |
Architecture Preview
┌─────────────────────────────────────────────────────────────────┐ │ EMAIL ASSISTANT FLOW │ ├─────────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────┐ ┌─────────────────┐ ┌─────────────┐ │ │ │ Gmail API │────▶│ Email Processor │────▶│ Gemini AI │ │ │ └─────────────┘ └────────┬────────┘ └──────┬──────┘ │ │ │ │ │ │ ▼ ▼ │ │ ┌─────────────────┐ ┌─────────────┐ │ │ │ SQLite Metrics │ │ Categorizer │ │ │ └─────────────────┘ └──────┬──────┘ │ │ │ │ │ ▼ │ │ ┌─────────────┐ │ │ │ Digest │ │ │ │ Generator │ │ │ └──────┬──────┘ │ │ │ │ │ ▼ │ │ ┌─────────────┐ │ │ │ Web │ │ │ │ Dashboard │ │ │ └─────────────┘ │ │ │ └─────────────────────────────────────────────────────────────────┘
Tracked Metrics
The system tracks 12+ comprehensive metrics for complete observability:
1
Total Emails Processed
2
Cache Hit Rate
3
API Calls Made
4
Avg Execution Time
5
Emails by Category
6
Success Rate
7
Script Run Count
8
Error Count
9
Avg API Response Time
10
Estimated API Cost
11
Cache Utilization
12
Recent Errors
Project Metrics
v2.1
Version
3.14+
Python
55+
Tests
Prod
Status