grok-register  by AaronL725

Grok account registration automation toolkit

Created 2 months ago
1,389 stars

Top 28.4% on SourcePulse

GitHubView on GitHub
Project Summary

This Python tool automates Grok account registration, targeting researchers, testers, and learners. It provides a stable, feature-rich solution for batch account creation, integrating with tools like grok2api and CPA, and offering robust error recovery.

How It Works

Leveraging real Chromium/Chrome instances, the project automates Grok account registration, including CAPTCHAs, profile completion, and SSO cookie acquisition. It integrates with four temporary email services (DuckMail, YYDS, Cloudflare, Cloud Mail) and features robust error handling with pending recovery. Novelty lies in its comprehensive post-processing, enabling grok2api token pooling and CPA xAI OIDC credential export, alongside reliable browser automation and recovery mechanisms.

Quick Start & Requirements

Clone the repo, set up a Python 3.9+ virtual environment, and install dependencies (pip install -r requirements.txt). Configure config.json with API keys and service details. Run via GUI (python grok_register_ttk.py) or CLI (python grok_register_ttk.py cli). Requires Google Chrome/Chromium and network access. Tkinter is needed for GUI.

Highlighted Details

  • Automated registration via real Chromium/Chrome, handling CAPTCHAs, Turnstile, and SSO cookies.
  • Supports four temporary email providers: DuckMail, YYDS, Cloudflare, and Cloud Mail.
  • Robust account management with *.pending.jsonl for idempotent recovery and success logging to accounts_*.txt.
  • Optional integration for grok2api token pooling and export of CPA xAI OIDC credentials.
  • Includes features like NSFW enabling, browser retries, and automatic cleanup.

Maintenance & Community

The README mentions general community acknowledgment (linux.do) but provides no specific details on active contributors, sponsorships, or direct community channels (e.g., Discord, Slack).

Licensing & Compatibility

Licensed under MIT, permitting broad use. However, a project disclaimer restricts usage against external terms of service, prohibiting unauthorized commercial use or platform circumvention. This necessitates careful review of Grok's and email providers' terms.

Limitations & Caveats

Effectiveness depends on external service availability (Grok, email APIs) and is subject to changes in their registration processes. CLI mode still launches a browser. Obtaining necessary API keys and configuring proxies is required. The project's disclaimer overrides the permissive MIT license for certain use cases.

Health Check
Last Commit

16 hours ago

Responsiveness

Inactive

Pull Requests (30d)
12
Issues (30d)
11
Star History
1,373 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.