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…

354 ·GitHub
Github-farm
What is this?It is an automation framework that farms GitHub OAuth signup bonuses across multiple AI-gateway platforms (Tabi AI, GoRouter, CodeBuddy Global) by generating email aliases, catching their OTP codes over IMAP, and harvesting the resulting OAuth sessions.
Is this a CLI tool or a hosted service?It is a local Python CLI framework, built with a --json output mode specifically so AI coding agents (Hermes, Codex, Claude Code) can drive the whole workflow programmatically.
How do I run through a full harvesting cycle?You configure the tool, generate email variations with the Gmail dot-trick or ProtonMail plus-addressing, capture the OTP in real time via IMAP, and then inject the resulting session directly into a local AI Gateway called 9Router.
What do I need set up before I can run it?A Gmail account with 2-Step Verification enabled and a 16-character App Password for IMAP, plus a dedicated clean proxy (mobile 4G/5G or residential ISP) for each registration session.
What's the biggest pitfall when using this?GitHub's WAF instantly flags signups coming from datacenter or commercial-hosting ASNs (Cloudflare, AWS, DigitalOcean); you must burn one clean mobile/residential IP per registration or the account gets shadowbanned.
Which platforms does it currently target?Three OAuth-gated AI credit services: Tabi AI (gives a $120 welcome balance plus $5-10 daily), GoRouter ($70 welcome balance plus $5-10 daily), and CodeBuddy Global (250 bonus credits plus 100/month).
What is 9Router?It is the local AI Gateway the tool injects harvested OAuth sessions into directly, so the sessions can be used as upstream API access.
Why does it use both the Gmail dot-trick and ProtonMail plus-addressing?Both tricks let a single real inbox generate unlimited unique-looking email addresses, which is how the tool repeatedly claims each platform's one-time welcome bonus.
Can an AI agent run the whole process without a human?Yes, every CLI command exposes a --json flag specifically designed for agents like Hermes, Codex, and Claude Code to parse and chain commands automatically.
What are similar projects?GuJumpgate, grok-register, FlowPilot, gogcli, botasaurus, omamail, gmail-account-creator, treg
Which topics is it in?credentials, fake, multi-account, anti-bot, anti-detection, gmail, imap, bypass, oauth2, email, telegram, oauth
Creator
d4ncboz
Size
<0.1 MB
Stars
354
Updated
CommitAug 20
Age
1mo
Commits · 90 Days