Email Organizer

This repository is a self-hosted version of our paid offering for organizing your email with AI. Simply run it, connect it to your IMAP server, explain in natural language how you want your mail organized, and forget it!

Key problems we solve:

1. No more hand writing email sieve/filter rules!
2. Separate out marketing emails from receipts / transaction confirmations.
3. Automatically star high importance emails based off learning your own preference.
4. Automatically recommend new folders/organization rules based off your own activity. For example, if you have a social media folder, and you start using tiktok, this service can recommend adding that as an organization rule.

Roadmap:

1. Prototype - Setting up the base infrastructure and user experience
2. MVP - enter your imap server. You list out folders and rules, and once a day emails in the "Pending" folder will be reorganized.
3. "Import" your list of folders from your imap server
4. Polling every 5 minutes, working off recent emails since last poll
5. Label support for services like gmail
6. Generate config to automate integration into imap servers like dovecot or gmail or proton
7. Supporting auth / multi user. Admin controls the list of users, users control their folders.
8. Making a paid, hosted version
9. Auth via google / facebook / etc.
10. Automatically star based off of your habits

Architectural concepts:

1. The web application is built using Flask for a web server.
2. HTMX is used to give SPA-like experience.
3. AlpineJS is used for anything
4. DaisyUI is used (on top of tailwind css) for the front end experience.
5. Everything is stored in postgres
6. OpenAI-compatible endpoints are used for email classification.

How it works:

1. The user interface allows the user to specify a list of folders, and in plain language what content should go in those folders
2. When an email is considered, a prompt is generated from all of the user input, specifying the rules, as well as a detailed system prompt.
3. If an email cannot be organized, it's left in place

Initial data model:

1. Users (id | user_name | salted_password_hash | imap_server | imap_password )
2. Folders (id | user_id | organization_rule | priority)