Auto-GPT Email Plugin: Revolutionize Your Email Management with Auto-GPT 🚀

The Auto-GPT Email Plugin is an innovative and powerful plugin for the groundbreaking base software, Auto-GPT. Harnessing the capabilities of the latest Auto-GPT architecture, Auto-GPT aims to autonomously achieve any goal you set, pushing the boundaries of what is possible with artificial intelligence. This email plugin takes Auto-GPT to the next level by enabling it to send and read emails, opening up a world of exciting use cases.

🌟 Key Features

• 📬 Read Emails: Effortlessly manage your inbox with Auto-GPT's email reading capabilities, ensuring you never miss important information.
• 📤 Auto-Compose and Send Emails: Auto-GPT crafts personalized, context-aware emails using its advanced language model capabilities, saving you time and effort.
• 📝 Save Emails to Drafts Folder: Gain more control by letting Auto-GPT create email drafts that you can review and edit before sending, ensuring your messages are fine-tuned to your preferences.
• 📎 Send Emails with Attachments: Effortlessly send emails with attachments, making your communication richer and more comprehensive.
• 🛡️ Custom Email Signature: Personalize your emails with a custom Auto-GPT signature, adding a touch of automation to every message sent by Auto-GPT.
• 🎯 Auto-Reply and Answer Questions: Streamline your email responses by letting Auto-GPT intelligently read, analyze, and reply to incoming messages with accurate answers.
• 🔌 Seamless Integration with Auto-GPT: Enjoy easy setup and integration with the base Auto-GPT software, opening up a world of powerful automation possibilities.

Unlock the full potential of your email management with the Auto-GPT Email Plugin and revolutionize your email experience today! 🚀

🔧 Installation

Follow these steps to configure the Auto-GPT Email Plugin:

1. Clone the Auto-GPT-Email-Plugin repository

Clone this repository and navigate to the Auto-GPT-Email-Plugin folder in your terminal:

git clone https://github.com/riensen/Auto-GPT-Email-Plugin.git

2. Install required dependencies

Execute the following command to install the necessary dependencies:

pip install -r requirements.txt

3. Package the plugin as a Zip file

Compress the Auto-GPT-Email-Plugin folder or download the repository as a zip file.

4. Install Auto-GPT

If you haven't already, clone the Auto-GPT repository, follow its installation instructions, and navigate to the Auto-GPT folder.

5. Copy the Zip file into the Auto-GPT Plugin folder

Transfer the zip file from step 3 into the plugins subfolder within the Auto-GPT repo.

6. Locate the .env.template file

Find the file named .env.template in the main /Auto-GPT folder.

7. Create and rename a copy of the file

Duplicate the .env.template file and rename the copy to .env inside the /Auto-GPT folder.

8. Edit the .env file

Open the .env file in a text editor. Note: Files starting with a dot might be hidden by your operating system.

9. Add email configuration settings

Append the following configuration settings to the end of the file:

################################################################################
### EMAIL (SMTP / IMAP)
################################################################################

EMAIL_ADDRESS=
EMAIL_PASSWORD=
EMAIL_SMTP_HOST=smtp.gmail.com
EMAIL_SMTP_PORT=587
EMAIL_IMAP_SERVER=imap.gmail.com

#Optional Settings
EMAIL_MARK_AS_SEEN=False
EMAIL_SIGNATURE="This was sent by Auto-GPT"
EMAIL_DRAFT_MODE_WITH_FOLDER=[Gmail]/Drafts

1. Email address and password:

   • Set EMAIL_ADDRESS to your sender email address.
   • Set EMAIL_PASSWORD to your password. For Gmail, use an App Password.

2. Provider-specific settings:

   • If not using Gmail, adjust EMAIL_SMTP_HOST, EMAIL_IMAP_SERVER, and EMAIL_SMTP_PORT according to your email provider's settings.

3. Optional settings:

   • EMAIL_MARK_AS_SEEN: By default, processed emails are not marked as SEEN. Set to True to change this.
   • EMAIL_SIGNATURE: By default, no email signature is included. Configure this parameter to add a custom signature to each message sent by Auto-GPT.
   • EMAIL_DRAFT_MODE_WITH_FOLDER: Prevents emails from being sent and instead stores them as drafts in the specified IMAP folder. [Gmail]/Drafts is the default drafts folder for Gmail.

10. Allowlist Plugin

In your .env search for ALLOWLISTED_PLUGINS and add this Plugin:

################################################################################
### ALLOWLISTED PLUGINS
################################################################################

#ALLOWLISTED_PLUGINS - Sets the listed plugins that are allowed (Example: plugin1,plugin2,plugin3)
ALLOWLISTED_PLUGINS=AutoGPTEmailPlugin

🧪 Test the Auto-GPT Email Plugin

Experience the plugin's capabilities by testing it for sending and receiving emails.

📤 Test Sending Emails

1. Configure Auto-GPT: Set up Auto-GPT with the following parameters:

   • Name: CommunicatorGPT
   • Role: Communicate
   • Goals:
     1. Goal 1: Send an email to my-email-plugin-test@trash-mail.com to introduce yourself
     2. Goal 2: Terminate

2. Run Auto-GPT: Launch Auto-GPT, which should use the email plugin to send an email to my-email-plugin-test@trash-mail.com.

3. Verify the email: Check your outbox to confirm that the email was sent. Visit trash-mail.com and enter your chosen email to ensure the email was received.

4. Sample email content: Auto-GPT might send the following email:

   Hello,
   
   My name is CommunicatorGPT, and I am an LLM. I am writing to introduce myself and to let you know that I will be terminating shortly. Thank you for your time.
   
   Best regards,
   CommunicatorGPT
   

📬 Test Receiving Emails and Replying Back

1. Send a test email: Compose an email with a simple question from a trash-mail.com email address to your configured EMAIL_ADDRESS in your .env file.

2. Configure Auto-GPT: Set up Auto-GPT with the following parameters:

   • Name: CommunicatorGPT
   • Role: Communicate
   • Goals:
     1. Goal 1: Read my latest emails
     2. Goal 2: Send back an email with an answer
     3. Goal 3: Terminate

3. Run Auto-GPT: Launch Auto-GPT, which should automatically reply to the email with an answer.

🎁 Test Sending Emails with Attachment

1. Send a test email: Compose an email with a simple question from a trash-mail.com email address to your configured EMAIL_ADDRESS in your .env file.

2. Place attachment in Auto-GPT workspace folder Insert the attachment intended for sending into the Auto-GPT workspace folder, typically named auto_gpt_workspace, which is located within the cloned Auto-GPT Github repository.

3. Configure Auto-GPT: Set up Auto-GPT with the following parameters:

   • Name: CommunicatorGPT
   • Role: Communicate
   • Goals:
     1. Goal 1: Read my latest emails
     2. Goal 2: Send back an email with an answer and always attach happy.png
     3. Goal 3: Terminate

4. Run Auto-GPT: Launch Auto-GPT, which should automatically reply to the email with an answer and the attached file.