Mailogy
My.Movie.4.mp4
Interact with your email records using natural language. You can say:
- “Give me every receipt in my inbox in CSV format, with the following columns: gmail link to the email, sender email, sender name, amount in the receipt.”
- “Give me every subscription in my inbox including cancelled subscriptions. ""
- “Tell me every service I’ve ever logged into or signed up for along with time of last login”
How to Download Your Gmail as a .mbox File
To download your Gmail emails in .mbox format, follow these steps:
- Go to your Google Account by navigating to https://myaccount.google.com/.
- On the left navigation panel, click on
Data & privacy. - Scroll down to the
Data from apps and services you usesection and click onDownload your data. - You will be redirected to the Google Takeout page. By default, all data types are selected. Click on
Deselect all. - Scroll down to
Mailand check the box next to it. - You can choose to include all your email labels or select specific labels by clicking on
All mail data included. - After making your selection, scroll down to the bottom of the list and click on
Next step. - Choose your preferred file type, frequency, and destination for the data export. For
.mboxfiles, you can leave the default settings. - Click on
Create export. Google will then prepare your download, which may take some time depending on the amount of data. - Once the export is ready, Google will email you a link to download your
.mboxfile. Follow the instructions in the email to download the file to your computer.
Usage Guide
Note: You will need an OpenAI API key to run this program. You can set it as an environmental variable, otherwise your will be prompted to enter your first time.
-
Clone this repo using the following command:
git clone http://github.com/granawkins/mailogy -
Install the required dependencies with pip:
pip install -r requirements.txt -
To process your
.mboxfile, run the program using the following command:python -m mailogy path_to_your_mbox_file.mboxReplace
path_to_your_mbox_file.mboxwith the actual path to your.mboxfile. -
Follow the on-screen prompts to interact with the program and process your email records using natural language commands.
-
After your
.mboxfile has been processed, can load your complete library again (without delay) by running:If you do include a path, you will be guided through the same procedure as #3.
Running OpenAI-compatible models
- Edit ~/.mailbox/config.yaml file:
llm_base_url: https://api.mistral.ai/v1 llm_api_key: mistral-api-key llm_model: mistral-tiny
Running local models using ollama
- Run
ollama serveon our terminal. - Edit ~/.mailbox/config.yaml file:
llm_base_url: http://127.0.0.1:11434 llm_model: ollama_chat/mistral