huey1in/windsurfx

WindsurfX is a Python command-line tool, written in Chinese, that automates the signup process for Windsurf, which is an AI coding assistant at windsurf.com. The README is upfront that the repository is meant for studying HTTP protocols, concurrent programming, and the use of disposable email APIs, and adds a notice that the tool should not be used in ways that violate Windsurf's terms of service, with all risk falling on the user. The tool's job is to register many Windsurf accounts in a row, without a human having to click through each signup. It does this by generating random email addresses, passwords, and nicknames, submitting the signup to Windsurf, then polling a disposable email service called moemail to read back the verification code and complete the signup. Successful accounts are saved to a JSON file with all the tokens and keys returned by Windsurf. The headline features described in the README are batch registration with no human attendance, configurable concurrency through a thread pool, support for a single proxy or a proxy pool file with random per-task assignment, persistence of full credentials such as auth tokens, session tokens, and API keys to accounts.json, and graceful shutdown on Ctrl+C so that in-flight tasks are allowed to finish without losing already-registered accounts. The code is split into small modules, each with a single job: config and constants, shared state across threads, logging, random generators for emails and passwords, a Windsurf API client, a moemail client with verification-code polling, storage for accounts.json, a single-account registration flow, and a runner that schedules everything concurrently. To use it, the README asks you to install Python 3.10 or later, pip install requests and python-dotenv, host or have access to a moemail instance and put its base URL and API key in a .env file, and then run main.py with flags for count, concurrency, proxy, proxy file, and output path. The author notes that Windsurf's free tier only opens SWE-series models, and that accessing Claude, GPT, or Gemini through a registered account requires binding a credit card for the Pro trial. They also say that whether the project keeps being maintained, and whether a graphical version is built for less technical users, will depend on how many GitHub stars it gets. The project is licensed under MIT.