Mood2Mail

Mood2Mail is an intelligent email tone analyzer and composition tool that helps users write more effective emails by providing real-time feedback on the emotional tone of their messages.

Features

• Real-time Tone Analysis: Analyzes your email content as you type and classifies it into one of five tones: Friendly, Formal, Aggressive, Anxious, or Passive.
• Visual Feedback: Changes the composition area's color based on the detected tone for immediate visual feedback.
• Personalized Suggestions: Provides specific tips to improve your email based on the detected tone.
• Email Sending: Send emails directly through the platform with your tone-optimized content.
• Responsive Design: Works smoothly on desktop and mobile devices.
• Dark Theme: Modern dark interface for comfortable use.

Technology Stack

• Backend: Flask (Python)
• Frontend: HTML, CSS, JavaScript
• Machine Learning: Naive Bayes classifier with TF-IDF vectorization
• Email Handling: SMTP integration via Python's smtplib

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/mood2mail.git
   cd mood2mail
   

2. Install the required dependencies:

   pip install -r requirements.txt
   

3. Configure email settings:

   • Copy config.example.py to config.py:

     cp config.example.py config.py
     

   • Edit config.py and update the email configuration
   • For Gmail, you'll need to create an App Password

4. Set up environment variables (optional):

   • Copy .env.example to .env:

     cp .env.example .env
     

   • Edit .env with your specific settings
   • This is an alternative to updating config.py

5. Run the application:

   python app.py
   

6. Access the application in your browser:

   http://127.0.0.1:5000
   

Deployment on Render

1. Create a new Web Service on Render:

   • Sign up/log in to Render
   • Click "New +" and select "Web Service"
   • Connect to your GitHub repository

2. Configure the Web Service:

   • Name: mood2mail (or your preferred name)
   • Environment: Python 3
   • Build Command: pip install -r requirements.txt
   • Start Command: gunicorn app:app

3. Set Environment Variables:

   • In the Render dashboard, go to "Environment" tab and add:
     • SECRET_KEY: a secure random string (e.g., generate with python -c "import secrets; print(secrets.token_hex(24))")
     • SMTP_SERVER: your SMTP server (e.g., smtp.gmail.com)
     • SMTP_PORT: your SMTP port (e.g., 587 for Gmail with TLS)
     • EMAIL_ADDRESS: your sender email address
     • EMAIL_PASSWORD: your app password (for Gmail, generate at https://myaccount.google.com/apppasswords)
     • USE_TLS: true or false (typically true for Gmail)
     • ADMIN_EMAIL: your admin email address to access settings

4. Deploy:

   • Click "Create Web Service"
   • Render will automatically build and deploy your application

5. First Time Setup:

   • Log in to your application using your admin email (the one you set in ADMIN_EMAIL)
   • If you've properly set all environment variables, the email functionality should work immediately

Important Notes for Deployment

1. Email Configuration:

   • When deployed on Render, the application will use the environment variables for email settings
   • You don't need to configure them through the application's settings page

2. Security:

   • Never commit your email password or app password to GitHub
   • Always use environment variables for sensitive information

3. Free Tier Limitations:

   • On Render's free tier, your service will spin down after periods of inactivity
   • The first request after inactivity may take 30-45 seconds to respond

Usage

1. Login: Enter your email address to start using the application.

2. Compose: Write your email in the composition area.

   • As you type, the system will analyze your text in real-time
   • The composition area will change color based on the detected tone
   • Review the tone analysis and feedback below the composition area

3. Send: Enter the recipient's email address and subject, then send your email.

Tone Categories

• Friendly: Warm, approachable communication ideal for building rapport
• Formal: Professional, structured communication appropriate for business context
• Aggressive: Direct, forceful language that may come across as confrontational
• Anxious: Uncertain or worrisome tone that may convey lack of confidence
• Passive: Indirect communication that may lack clarity or assertiveness

Administrator Settings

The application allows admin users to configure email sending settings:

• Access admin settings by logging in with an admin email account
• Configure SMTP server, port, credentials, and security settings

Future Improvements

• Multi-language support
• User accounts with saved preferences
• Email templates library
• Integration with popular email clients
• Advanced tone analysis with more categories
• Sentence-level tone suggestions

License

This project is licensed under the MIT License - see the LICENSE file for details.

Creator

Developed by Mayank Bansal