github-farm README

The project's README from github.com/d4ncboz/github-farm. As one markdown file: README.md.

⚡ GitHub OAuth Multi-Platform Harvesting Framework

Production-grade, AI-Agent-friendly automation framework for scalable identity generation, real-time IMAP OTP capture, and multi-platform OAuth token harvesting.


📖 Overview

GitHub OAuth Harvester is a modular automation framework designed for developer teams and AI Agents to securely streamline multi-platform OAuth session management. By combining RFC-compliant email aliasing, clean proxy enforcement, SSL IMAP listeners, and universal database ingestion, developers can systematically maintain API access across leading developer platforms.


🎯 Target Platforms & Allowance Matrix

Platform Authentication Flow Currency / Unit Type Welcome Allowance Periodic Allocation Portal & Signup
Tabi AI GitHub OAuth USD Balance ($) $120.00 USD +$5–$10 / Daily Check-in tabitoken.com
GoRouter GitHub OAuth USD Balance ($) $70.00 USD +$5–$10 / Daily Check-in gorouter.app
CodeBuddy Global GitHub Keycloak OIDC Usage Credits 250 Bonus Credits +100 Credits / Month codebuddy.ai

🛡️ Critical Network & Security Prerequisites

1. Mandatory Clean Proxy Rule

GitHub's Web Application Firewall (WAF) strictly monitors signup requests for anomaly patterns. To prevent instant account flagging or shadowbans:

2. Google IMAP 16-Digit App Password Setup

To enable autonomous OTP retrieval without webmail interaction:

  1. Enable 2-Step Verification on your master Google account.
  2. Navigate to myaccount.google.com/apppasswords.
  3. Generate a dedicated app password (e.g. GitHub Harvester).
  4. Provide the 16-character string (abcdefghijklmnop) in your configuration.

🤖 AI Agent Friendly Interface (--json)

This framework is built natively for AI Agents (Hermes, Codex, Claude Code). All CLI commands support the --json flag for machine-readable output:

# Generate 10 email aliases in JSON format
python3 main.py generate --user masteruser --domain gmail.com --count 10 --json

# Real-time OTP listener with JSON response
python3 main.py listen-otp --user [email protected] --password 16digitapppassword --json

🚀 Quick Start Guide

1. Configuration Setup

cp config/config.example.toml config/config.toml

2. Generate Email Variations

3. Real-Time OTP Capture

python3 main.py listen-otp --user [email protected] --password your_16_digit_app_password --timeout 120

4. Direct Session Injection to Local AI Gateway (9Router)

python3 main.py inject --platform codebuddy --token "<RAW_JWT_TOKEN>"

🌐 Community & Official Support


📄 License

Released under the MIT License. Author: D4NNBOZ.

github-farm (d4ncboz/github-farm)

Searching Database…

这是什么?它是一个自动化框架,通过生成邮箱别名、用 IMAP 截取验证码(OTP)并收集得到的 OAuth 会话,在多个 AI 网关平台(Tabi AI、GoRouter、CodeBuddy Global)上刷取 GitHub OAuth 注册奖励。
它是命令行工具还是托管服务?它是本地的 Python 命令行框架,专门构建了 --json 输出模式,让 AI 编程智能体(Hermes、Codex、Claude Code)能够以编程方式驱动整个工作流。
怎么跑完一个完整的收集流程?先配置工具,用 Gmail 加点技巧或 ProtonMail 加号寻址生成邮箱变体,通过 IMAP 实时截获 OTP 验证码,然后把得到的会话直接注入一个名为 9Router 的本地 AI 网关。
运行之前需要准备好什么?需要一个开启了两步验证的 Gmail 账号和用于 IMAP 的 16 位应用专用密码,另外每次注册会话还需要一个专属的干净代理(移动 4G/5G 或住宅 ISP)。
使用它最大的坑是什么?GitHub 的 WAF 会立即标记来自数据中心或商业托管 ASN(Cloudflare、AWS、DigitalOcean)的注册;每次注册必须消耗一个干净的移动/住宅 IP,否则账号会被暗中封禁(shadowban)。
它目前针对哪些平台?三个以 OAuth 为门槛的 AI 额度服务:Tabi AI(提供 $120 迎新余额外加每日 $5-10)、GoRouter($70 迎新余额外加每日 $5-10)和 CodeBuddy Global(250 赠送额度外加每月 100)。
9Router 是什么?它是本地的 AI 网关,工具会把收集到的 OAuth 会话直接注入其中,让这些会话可以用作上游 API 访问。
为什么它同时使用 Gmail 加点技巧和 ProtonMail 加号寻址?这两种技巧都能让一个真实收件箱生成无限个看起来各不相同的邮箱地址,工具正是靠这一点反复领取每个平台的一次性迎新奖励。
AI 智能体能不需要人工跑完整个流程吗?可以,每个命令行命令都提供 --json 标志,专门为 Hermes、Codex 和 Claude Code 这类智能体设计,便于解析并自动串联命令。
Creator
d4ncboz
Size
<0.1 MB
Stars
354
Updated
CommitAug 20
Age
1mo
Commits · 90 Days