A modern, AI-powered email client re-imagined for productivity. Built with React (Vite) and FastAPI.
- Standard Email Actions: Compose, Reply, Star, Trash, Archive.
- Fast Full-Text Search: Instantly find emails.
- AI Analysis: Automatically detects Events, Deadlines, and Action Items (RAG pipeline in progress).
- Persistent Sync: Robust syncing engine with Gmail API.
- Frontend: React, Tailwind CSS, Lucide Icons, Vite
- Backend: Python FastAPI, SQLAlchemy (Async), Pydantic
- Database: PostgreSQL (with pgvector support planned)
- Integration: Gmail API (OAuth2)
- Node.js & npm
- Python 3.10+
- PostgreSQL
- Google Cloud Project with Gmail API enabled
-
Clone the repository
git clone https://github.com/manvith2003/magic-Mail.git cd magic-Mail -
Backend Setup
cd backend python3 -m venv venv source venv/bin/activate pip install -r requirements.txt # Setup .env (see backend/.env.example) # Run Migrations (if any) # alembic upgrade head # Start Server uvicorn app.main:app --reload
-
Frontend Setup
cd frontend npm install npm run dev
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.