{"id":26561865,"url":"https://github.com/burnycoder/gmail-unsubscribe-agent","last_synced_at":"2026-04-17T08:04:10.378Z","repository":{"id":282056035,"uuid":"946747537","full_name":"BurnyCoder/gmail-unsubscribe-agent","owner":"BurnyCoder","description":"A simple agent that helps you unsubscribe from unwanted emails by finding messages with \"unsubscribe\" in them and extracting the unsubscribe links. Uses browser-use and Anthropic Claude via Portkey API gateway using Langchain.","archived":false,"fork":false,"pushed_at":"2025-03-19T20:29:10.000Z","size":38,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"2","last_synced_at":"2025-03-19T21:37:07.513Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BurnyCoder.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-11T16:02:31.000Z","updated_at":"2025-03-19T20:29:14.000Z","dependencies_parsed_at":"2025-03-19T21:29:49.489Z","dependency_job_id":null,"html_url":"https://github.com/BurnyCoder/gmail-unsubscribe-agent","commit_stats":null,"previous_names":["burnycoder/gmail-unsubscribe-agent"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BurnyCoder%2Fgmail-unsubscribe-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BurnyCoder%2Fgmail-unsubscribe-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BurnyCoder%2Fgmail-unsubscribe-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BurnyCoder%2Fgmail-unsubscribe-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BurnyCoder","download_url":"https://codeload.github.com/BurnyCoder/gmail-unsubscribe-agent/tar.gz/refs/heads/2","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244966522,"owners_count":20539797,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-22T14:18:36.516Z","updated_at":"2026-04-17T08:04:10.337Z","avatar_url":"https://github.com/BurnyCoder.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gmail Unsubscribe Agent\n\nThis is an automated agent that helps you manage your Gmail inbox by either:\n- Unsubscribing from unwanted emails (default functionality)\n- Summarizing your most recent emails\n\nThe agent uses Chrome browser automation and LLM-powered browsing to navigate through Gmail.\n\nThis project leverages browser-use and Anthropic Claude via Portkey API gateway using Langchain.\n\n## Prerequisites\n\n- Python 3.11 or higher\n- Chrome or Chromium browser\n- API keys for Anthropic Claude (via Portkey)\n\n## Setup\n\n1. Make sure you have all dependencies installed:\n   ```\n   pip install -r requirements.txt\n   ```\n\n2. Copy the environment template to create your own `.env` file:\n   ```\n   cp .envtemplate .env\n   ```\n\n3. Edit the `.env` file to add your API keys:\n   ```\n   PORTKEY_API_BASE=your_portkey_api_base_here\n   PORTKEY_API_KEY=your_portkey_api_key_here\n   PORTKEY_VIRTUAL_KEY_ANTHROPIC=your_portkey_virtual_key_here\n   # Optional: You can customize the agent's behavior by setting a custom prompt\n   GMAIL_AGENT_PROMPT=\"Your custom prompt here\"\n   ```\n\n## Running the Agent\n\nThere are two ways to run the agent:\n\n### Option 1: Manual two-step process, good for first time\n\n1. First, start Chrome with remote debugging enabled:\n   ```\n   python chrome_manager.py\n   ```\n   This will open Chrome to Gmail. You may need to log in to your Gmail account.\n\n2. Once Chrome is running with remote debugging, run the agent:\n   ```\n   python gmail_agent.py\n   ```\n\n### Option 2: Using the integrated script (when you're logged in already)\n\nRun the all-in-one script that handles both Chrome startup and the agent:\n\n```\npython run_gmail_agent.py\n```\n\nThis script will:\n- Start Chrome with remote debugging enabled\n- Navigate to Gmail \n- Run the agent to process your emails\n- Properly clean up when finished or interrupted\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fburnycoder%2Fgmail-unsubscribe-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fburnycoder%2Fgmail-unsubscribe-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fburnycoder%2Fgmail-unsubscribe-agent/lists"}