MailAgent (miniAgent_SaaS)

AI email agent on Celo – reads your inbox, filters important emails (finance, jobs, crypto, security), and sends smart summaries to Telegram.

Features

• 📧 Email – Gmail IMAP, unread detection
• 🤖 AI – Claude-powered importance scoring, keyword fallback
• 📱 Telegram – Instant alerts
• ⛓️ Celo – On-chain logging (Sepolia / Mainnet)
• 🧾 Invoice – Detect & pay invoices via Telegram
• 📌 Priority emails – Always track specific senders (e.g. boss)

Quick Start

cd backend
pip install -r requirements.txt
copy .env.example .env
# Edit .env with your email, Telegram, Celo credentials
python main.py

Open http://localhost:8000 or http://localhost:8000/app.html.

📖 QUICKSTART.md – Full setup guide
🚀 Deployment.md – Deploy to Render, Vercel, Celo

Stack

• Backend: FastAPI, Python 3.11+
• Frontend: Vanilla JS, served by backend
• Blockchain: Celo (Sepolia testnet)
• AI: Claude (optional), keyword classifier fallback

License

MIT