• 100% Local: Your data never leaves your device
• Gmail App Password: Secure authentication (no real password used)
• CSV/Excel Upload: Supports .csv, .xlsx, .xls
• Smart Placeholders: {{ firstName }} — case and space tolerant
• Live Preview: Real-time HTML rendering
• Test Email: Send to yourself before bulk
• Attachments: PDFs, images, documents
• Progress Tracking: Real-time log and progress bar
• Markdown & HTML: Full email formatting support
• Gmail-Safe: 2-second delay between sends

pip install sahajmails
sahajmails

Open http://localhost:8501

1. Upload your contact list (must have email column)
2. Enter your Gmail and App Password
3. Compose email using {{ columnName }} placeholders
4. Click placeholder buttons to copy instantly
5. Attach files (optional)
6. Preview → Send Test Email
7. Start Bulk Send → Watch progress

Example CSV:

email,firstName,company
alice@example.com,Alice,Acme Corp
bob@work.com,Bob,StartupXYZ

1. Upload CSV/Excel – Instant contact preview with detected columns

2–3. Secure Gmail login • Rich editor with one-click placeholder buttons

4–5. Real-time live preview • Optional file attachments (up to 200 MB each)

6–7. Send test email • Start bulk send with real-time progress and completion status

1. Go to myaccount.google.com/security
2. Enable 2-Step Verification
3. Search "App Passwords"
4. Select App name → Generate
5. Copy the 16-character password → paste in the app

pip install sahajmails

Or from source:

git clone https://github.com/sahajrajmalla/sahajmails.git
cd sahajmails
pip install -e .

# Install dev dependencies
pip install -e .[dev]

# Run tests
pytest tests/

# Build package
python -m build

Contributions are welcome!

1. Fork the repo
2. Create a branch: git checkout -b feature/your-idea
3. Commit changes: git commit -m "feat: add X"
4. Push and open a Pull Request

Please follow PEP 8 and include tests.

• Runs entirely on your machine
• No data is stored or transmitted
• Open source under MIT License
• Uses Gmail App Passwords only

MIT License – Free for personal and commercial use.