Skip to content

Copy your email verification codes & links automatically

Notifications You must be signed in to change notification settings

mhaowork/verigood

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VeriGood Email Agent

The VeriGood Email Agent is a Python application designed to automate the process of reading verification codes or login links from Gmail using GPT.

Demo

Features

  • Fetches new emails automatically. Only Gmail is supported currently.
  • Uses OpenAI's GPT model to extract validation codes or links.
  • Copies validation codes or links to the clipboard.
  • Plays a beepy sound on macOS when a validation code / link is found.

Prerequisites

Before installing and running this program, ensure you have the following:

  • Python 3.10.7 or greater
  • Google Gmail API aka Google OAuth Client ID and Secret downloaded as credentials.json
    • Follow this Google guide until the Authorize credentials for a desktop application step where you will download your credentials.json
  • OpenAI API
    • Get your OpenAI API key. If you don't know how, check out this and this.

Installation

  1. Download this repo and enter the folder
git clone https://github.com/mhaowork/verigood
cd verigood
  1. Move credentials.json into the source code's folder.

  2. Export your OpenAI API key as an environment variable

export OPENAI_API_KEY='your-api-key-here'
  1. Install python dependencies (ideally in a virtual env)
pip install -r requirements.txt
  1. Run the main program
python gmail_agent.py
  1. You will be prompted to visit the google oauth URL to authorize the application.

    For example, you will see the following message:

Please visit this URL to authorize this application: https://accounts.google.com/o/oauth2/auth?response_type=code&client_id=xyz....
  1. Once the oauth is successful, your Google's auth tokens will be cached in token.json under the same folder so the oauth flow will be skipped in the future runs.

  2. Enjoy!

About

Copy your email verification codes & links automatically

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages