EmailGenius is an AI-driven email categorization tool that automates the process of sorting and labeling emails using the Opensource LLAMA API. It connects to an IMAP server, fetches emails, and categorizes them based on user-defined criteria. The project also includes a Streamlit interface for an interactive user experience.
The market offers various proprietary email categorization and management tools, including:
However, these tools have limitations, such as not being opensource and requiring payment and often adopting a pricing model based on each email account. With the ongoing democratization of AI, it's expected that even standard servers will be capable of running similar processes more affordably, accommodating any number of accounts within the next five years.
In contrast, widely-used email services like Microsoft Outlook, Gmail, and Zoho Mail can be cumbersome in setting up email filter rules, often involving numerous steps. Moreover, users frequently encounter issues where emails from unsubscribed websites persist in appearing in their inboxes.
openai==0.28
)git clone https://github.com/0xrushi/emailgenius.git
cd emailgenius
pip install -r requirements.txt
.env
file in the project root with the following variables:
OPENAI_API_KEY
- Your OpenAI API key.OPENAI_API_BASE
- OpenAI API base URL.USERNAME
- IMAP server username.PASSWORD
- IMAP server password.load_dotenv()
data/email_data.json
file:
streamlit run src/main.py -- --ingest true
streamlit run src/main.py
streamlit run src/main.py -- --approve true
Contributions to EmailGenius are welcome. Please follow the standard fork, branch, and pull request workflow.