An intelligent background assistant that monitors your Gmail inbox, generates human-like summaries using Google's Gemini AI, and delivers briefings directly to Slack or WhatsApp.
- Smart Summarization: Uses Gemini 2.5 Flash to create concise, executive-style briefings.
- Attachment Analysis: Downloads and incorporates context from email attachments into the summary.
- Multi-Platform Delivery: Supports notifications via Slack Webhooks and WhatsApp API.
- Continuous Monitoring: Automatically polls for and processes new unread emails.
- Language: Python 3
- AI Model: Google Gemini 1.5/2.5 Flash (
google-genai) - Email: Gmail API (
simplegmail) - Backend: Flask / Flask-RESTful
-
Clone the repository:
git clone <repository-url> cd Automated-Email-Briefing-Assistant
-
Install dependencies:
pip install -r requirements.txt
-
Configure Environment: Create a
.envfile in the root directory:GOOGLE_GENAI_API_KEY=your_gemini_api_key SLACK_WEBHOOK_URL=your_slack_webhook_url # Optional: For WhatsApp support WHATSAPP_URL=your_whatsapp_url AUTHORIZATION_HEADER=your_auth_token WHATSAPP_PHONE_NO=target_phone_number
-
Gmail Credentials:
- Enable the Gmail API in your Google Cloud Console.
- Download your OAuth
client_secret.json. - Place it in:
gmail_credentials/client_secret.json.
Run the application:
python app.pyOn the first run, a browser window will open to authenticate your Google account.