经 AI Skill Hub 精选评估,gmail-ai-unsub Agent工作流 获评「推荐使用」。这款Agent工作流在功能完整性、社区活跃度和易用性方面表现出色,AI 评分 6.8 分,适合有一定技术背景的用户使用。
gmail-ai-unsub Agent工作流 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排,将复杂的多步骤任务拆解为清晰的自动化流程,实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成,适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
gmail-ai-unsub Agent工作流 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排,将复杂的多步骤任务拆解为清晰的自动化流程,实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成,适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
# 方式一:pip 安装(推荐)
pip install gmail-ai-unsub
# 方式二:虚拟环境安装(推荐生产环境)
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
pip install gmail-ai-unsub
# 方式三:从源码安装(获取最新功能)
git clone https://github.com/zbowling/gmail-ai-unsub
cd gmail-ai-unsub
pip install -e .
# 验证安装
python -c "import gmail_ai_unsub; print('安装成功')"
# 命令行使用
gmail-ai-unsub --help
# 基本用法
gmail-ai-unsub input_file -o output_file
# Python 代码中调用
import gmail_ai_unsub
# 示例
result = gmail_ai_unsub.process("input")
print(result)
# gmail-ai-unsub 配置文件示例(config.yml) app: name: "gmail-ai-unsub" debug: false log_level: "INFO" # 运行时指定配置文件 gmail-ai-unsub --config config.yml # 或通过环境变量配置 export GMAIL_AI_UNSUB_API_KEY="your-key" export GMAIL_AI_UNSUB_OUTPUT_DIR="./output"
AI-powered tool to identify and automatically unsubscribe from marketing emails in Gmail using Large Language Models (LLMs) and browser automation.
Website: zacbowling.com
```bash
uv pip install -e .
pip install gmail-ai-unsub
Important: This tool's OAuth app is not yet verified with Google, so all users must create their own OAuth credentials to use the tool. This is a one-time setup that takes about 10 minutes.
Follow the steps below to create your own Google Cloud OAuth app. This is required for the tool to access your Gmail account.
Run the setup wizard to create your configuration:
gmail-unsub setup
This will guide you through: - Selecting your LLM provider (Gemini, Claude, or OpenAI) - Choosing a model and configuring settings - Setting up Gmail OAuth authentication (pointing to your credentials.json) - Customizing labels and classification prompts
1. Go to APIs & Services → OAuth consent screen 2. Choose External (unless you have a Google Workspace account) 3. Fill in the required information: - App name: Gmail AI Unsubscribe Tool (or your choice) - User support email: Your email - Developer contact information: Your email 4. Click Save and Continue 5. Scopes: Click "Add or Remove Scopes" and add: - https://www.googleapis.com/auth/gmail.readonly - https://www.googleapis.com/auth/gmail.modify - https://www.googleapis.com/auth/gmail.send 6. Click Save and Continue 7. Test users: Add your Google account email(s) as test users - This allows you to use the app while it's in "Testing" mode - Click Add Users and enter your email 8. Click Save and Continue 9. Review and click Back to Dashboard
3. **Set your LLM API key**:
bash export GOOGLE_API_KEY=your_gemini_api_key
Run the interactive setup wizard:
gmail-unsub setup
Options: - --force: Overwrite existing config file
See docs/configuration.md for detailed configuration options.
Key configuration sections: - [gmail]: Gmail API credentials - [llm]: LLM provider and model selection - [prompts]: Customizable prompts for email classification - [labels]: Gmail label names - [unsubscribe]: Browser automation settings
You must create your own OAuth app - the tool's app is not verified with Google yet. Follow the Gmail API Setup steps above to: 1. Create a Google Cloud project 2. Enable Gmail API 3. Configure OAuth consent screen 4. Create OAuth credentials 5. Download your credentials.json file
This is a one-time setup that takes about 10 minutes.
```
1. Set up Gmail API credentials (required): - Follow the Gmail API Setup steps above - Download your credentials.json file 2. Create a config file:
```bash cp config.example.toml ~/.gmail-ai-unsub/config.toml
http://localhost - this should work automaticallyFor more details, see docs/oauth-credentials.md.
Gmail AI Unsubscribe Tool 是一个使用大型语言模型 (LLMs) 和浏览器自动化的 AI 工具,用于在 Gmail 中识别并自动取消订阅营销邮件。
该工具的功能包括:使用 LLMs 进行营销邮件识别、自动取消订阅、Gmail 集成等。
该工具的环境依赖包括 Python 3.12 或更高版本、uv 或 pip、Gmail API 凭证和 LLM API 密钥等。
安装方式包括从源码安装、使用 uv 安装等。
使用该工具的步骤包括设置 OAuth 凭证、启用 Gmail API、配置 LLM API 密钥等。
配置说明包括设置 OAuth 凭证、配置 LLM API 密钥、编辑 config.toml 文件等。
该工具使用 Gmail API 进行操作,需要在 Google Cloud Console 中创建 OAuth 凭证和 API 密钥。
常见问题包括 "访问被阻止"、"无效客户端" 和 "重定向 URI 不匹配" 等。
基于Claude的创意应用,自动化程度高。Star数较少表明关注度有限,代码维护需加强,实用性中等。
AI Skill Hub 为第三方内容聚合平台,本页面信息基于公开数据整理,不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后,再部署至生产环境,并做好必要的安全评估。
✅ MIT 协议 — 最宽松的开源协议之一,可自由商用、修改、分发,仅需保留版权声明。
AI Skill Hub 点评:gmail-ai-unsub Agent工作流 的核心功能完整,质量良好。对于自动化工程师和运维人员来说,这是一个值得纳入个人工具库的选择。建议先在非生产环境试用,再逐步推广。
| 原始名称 | gmail-ai-unsub |
| 原始描述 | 开源AI工作流:AI-powered CLI tool to identify and automatically unsubscribe from marketing ema。⭐11 · Python |
| Topics | 邮件管理AI自动化Python工具浏览器自动化Claude集成 |
| GitHub | https://github.com/zbowling/gmail-ai-unsub |
| License | MIT |
| 语言 | Python |
收录时间:2026-05-14 · 更新时间:2026-05-24 · License:MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。
选择 Agent 类型,复制安装指令后粘贴到对应客户端