codex-register  by klsf

Automate OpenAI account registration and credential management

Created 1 month ago
360 stars

Top 77.7% on SourcePulse

GitHubView on GitHub
Project Summary

This project provides a Node.js-based tool for automating the batch registration of OpenAI accounts, generating Codex authorization files, and checking the remaining credit balance of existing credentials. It targets users who need to manage multiple OpenAI accounts programmatically, offering a way to streamline setup and verification processes, particularly for integration with services like cliproxyapi.

How It Works

The tool operates by leveraging various email providers (Gmail, Hotmail, GPTMail, etc.) to handle the account verification process during registration. Users configure the tool via config.json, specifying proxy settings and their preferred email provider. It can then execute automated registration and authorization flows, generating .json authorization files compatible with OpenAI's Codex or other API clients. A key feature is the check command, which scans local authorization files or interacts with a cliproxyapi instance to report on credential status and remaining quotas.

Quick Start & Requirements

  • Environment: Node.js 18+ required.
  • Installation: Run npm install to install dependencies.
  • Configuration: Duplicate config.example.json to config.json and set essential parameters like defaultProxyUrl, provider, and provider-specific credentials (e.g., API keys for Gmail).
  • Execution:
    • Development: npm run dev
    • Production: npm run build then npm run start
    • Check local auth files: npm run check
    • Check auth files via CLIProxyAPI: npm run check:cpa
  • Dependencies: A functional proxy is mandatory. Specific email providers may require additional API tokens or setup (e.g., Gmail API OAuth).

Highlighted Details

  • Multi-Provider Support: Integrates with several email verification services, including Gmail (with OAuth support), Hotmail, GPTMail, and Cloudflare Workers, offering flexibility in account creation.
  • CLIProxyAPI Integration: Features automatic uploading of generated authorization files to a cliproxyapi instance and can manage credential status (enable/disable) based on remaining quota directly through the API.
  • Batch Credential Management: Designed for bulk operations, enabling efficient registration, authorization file generation, and status checking for numerous accounts.
  • Automated Quota Monitoring: The check:cpa command provides automated monitoring and status updates for credentials managed via cliproxyapi.

Maintenance & Community

No specific information regarding maintainers, community channels (like Discord/Slack), or a public roadmap was found in the provided documentation.

Licensing & Compatibility

The repository does not explicitly state a software license. However, a prominent disclaimer warns that the project is intended solely for learning, research, and interface behavior testing. Users are responsible for ensuring their usage complies with target platform terms of service, local laws, and network policies. This implies potential restrictions on commercial use and a high risk of account suspension if used improperly.

Limitations & Caveats

The proxiedmail provider is explicitly marked as deprecated and no longer available. The tool's functionality heavily relies on the availability and configuration of external proxies and email services. Users must be aware of OpenAI's terms of service, as automated account creation and usage may violate them, leading to account suspension or other repercussions.

Health Check
Last Commit

1 week ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
112 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.