Any Auto Register

🇨🇳 中文版本

---

🙏 Acknowledgments

This project is a third-generation fork based on the following outstanding open-source projects. We sincerely thank the original authors for their contributions:

• Original Project (1st Gen): lxf746/any-auto-register by @lxf746
• Second Fork (2nd Gen): zc-zhangchen/any-auto-register by @zc-zhangchen
• Temporary Email Solution: dreamhunter2333/cloudflare_temp_email

---

⚠️ Disclaimer

This project is for learning and research purposes only. It shall not be used for any commercial or illegal purposes.

• Purpose Limitation: This project is solely for learning and technical research. It shall not be used for any commercial or illegal purposes.
• Legal Liability: All consequences arising from the use of this project shall be borne by the user. The author is not responsible for any losses, legal liabilities, or moral disputes caused by the use of this project.
• Compliance: Please ensure your use complies with local laws and regulations and the terms of service of each platform.
• Risk Assumption: Using this project for account registration may violate the terms of service of relevant platforms. Risks such as account bans and IP bans resulting therefrom shall be borne by the user.
• Author's Stance: The author firmly opposes any misuse of this project, including but not limited to mass account registration for fraud, harassment, spam dissemination, and other illegal activities.

---

📋 Table of Contents

• Introduction
• Features
• Supported Platforms
• Tech Stack
• Quick Start
• Configuration
• Email Services
• Captcha Services
• Usage Guide
• Register Accounts
• Scheduled Tasks
• Batch Upload
• Delete Accounts
• One-Click Update
• Project Structure
• API Documentation
• Troubleshooting
• Development Guide
• Docker Deployment
• Contributing
• License
• Star History

---

📖 Introduction

Any Auto Register is a multi-platform account automatic registration and management system with plugin-based extension, built-in Web UI, and automatic handling of captcha and email verification.

✨ Features

• 🎯 Multi-Platform Support: ChatGPT, Trae.ai, Cursor, Kiro, Grok, Tavily, OpenBlockLabs, and more
• 🔌 Plugin Architecture: Easy to extend new platforms with standardized interfaces
• 📧 Email Services: Support for 10+ temporary email and self-hosted email services
• 🤖 Captcha Handling: Integrated YesCaptcha and local Turnstile Solver
• 🌐 Proxy Support: Built-in proxy pool management for better anonymity
• 📊 Web UI: Beautiful and easy-to-use management interface
• 🔄 Scheduled Tasks: Support for automatic scheduled registration
• 📈 Batch Operations: Support for batch registration (up to 1000 accounts) and batch upload
• ⚡ Random Delay: Configurable registration interval with random delay
• 🚀 One-Click Deployment: Automated deployment and update scripts

---

🌐 Supported Platforms

Platform	Registration	Token Management	Status Sync	Notes
ChatGPT	✅	✅	✅	Full feature support
Trae.ai	✅	✅	❌
Cursor	✅	✅	❌
Kiro	✅	✅	❌	Requires self-hosted email
Grok	✅	✅	❌
Tavily	✅	❌	❌
OpenBlockLabs	✅	❌	❌

---

🛠️ Tech Stack

Backend

• Framework: FastAPI + Uvicorn
• Database: SQLite + SQLModel
• Browser Automation: Playwright + Camoufox
• HTTP Client: curl_cffi + httpx
• Task Scheduling: APScheduler

Frontend

• Framework: React + TypeScript
• UI Library: Ant Design
• Build Tool: Vite
• State Management: Zustand

Infrastructure

• Container: Docker + Docker Compose
• Environment: Conda (recommended) or venv

---

🚀 Quick Start

Prerequisites

• Python: 3.12 or higher
• Node.js: 18 or higher
• Conda: Recommended for environment management
• Git: For cloning the repository

Method 1: One-Click Deployment (Recommended)

# 1. Clone the repository
git clone https://github.com/dsclca12/auto_reg.git
cd auto_reg

# 2. Run deployment script
./deploy.sh

After deployment, access http://localhost:8000

Method 2: Manual Installation

1. Clone the Repository

git clone https://github.com/dsclca12/auto_reg.git
cd auto_reg

2. Create Python Environment

# Using Conda (recommended)
conda create -n any-auto-register python=3.12 -y
conda activate any-auto-register

# Or using venv
python3 -m venv any-auto-register-env
source any-auto-register-env/bin/activate  # Linux/Mac

3. Install Dependencies

pip install -r requirements.txt

4. Install Browsers

python -m playwright install chromium
python -m camoufox fetch

5. Install Frontend Dependencies

cd frontend
npm install
npm run build
cd ..

6. Configure Environment Variables

cp .env.example .env
# Edit .env file with your configuration

7. Start the Service

python main.py

Access http://localhost:8000

---

⚙️ Configuration

Environment Variables

Copy .env.example to .env and configure as needed:

# Server Configuration
HOST=0.0.0.0
PORT=8000
APP_RELOAD=0
APP_CONDA_ENV=any-auto-register

# Captcha Services
YESCAPTCHA_CLIENT_KEY=your_client_key
LOCAL_SOLVER_URL=http://127.0.0.1:8889

# Proxy (Optional)
PROXY_URL=http://username:password@ip:port

# Email Services (Configure based on your needs)
MOEMAIL_API_KEY=your_api_key
SKYMAIL_API_KEY=your_api_key
SKYMAIL_DOMAIN=your_domain

Email Services

Service	Identifier	Description	Configuration Required
LuckMail	luckmail	Temporary email service with API-based access	Yes
MoeMail	moemail	Default option, auto-register temporary email	Yes
TempMail.lol	tempmail_lol	Temporary email, may require proxy in some regions	No
SkyMail (CloudMail)	skymail	Use via API/Token/Domain	Yes
YYDS Mail / MaliAPI	maliapi	Support domain and auto-domain strategy	Yes
GPTMail	gptmail	Generate temporary email via GPTMail API	Yes
DuckMail	duckmail	Temporary email service	Yes
Freemail	freemail	Self-hosted email service	Yes
Laoudo	laoudo	Fixed email service	Yes
CF Worker	cfworker	Self-hosted Cloudflare Worker email	Yes

📧 Kiro Email Requirements

Kiro has strict risk control. Email solution significantly affects success rate:

• Self-hosted email: 100% success rate ✅
• Built-in temporary email: 0% success rate ❌

Recommendation: Use self-hosted email (CF Worker, SkyMail) for Kiro registration.

Captcha Services

Service	Description	Configuration
YesCaptcha	Third-party captcha solving service	Requires Client Key
Local Solver	Built-in Turnstile solver (camoufox + quart)	Auto-starts with backend

External System Integration

System	Description	Configuration
CPA	Codex Protocol API management panel	API URL + Key
Sub2API	API transit management	API URL + Key
Team Manager	Team management	-
grok2api	Grok token management	API URL + Key

---

📚 Usage Guide

Register Accounts

1. Visit Register Task page
2. Select platform and configuration
3. Set batch quantity (max 1000) and delay
4. Click Start Registration

Scheduled Tasks

1. Visit Scheduled Tasks page
2. Create task and set execution time
3. Supports one-time and recurring execution
4. System will automatically execute at scheduled time
5. Supports pause/resume

Batch Upload

1. Visit Account Management
2. Select platform
3. Select accounts (all or specific)
4. Click Batch Upload to Sub2API/CPA

ChatGPT Token Modes

The frontend provides two ChatGPT registration modes:

Mode	Description	Output	Recommendation
With Refresh Token	Uses new PR flow	Access Token + Refresh Token	✅ Recommended
Without Refresh Token	Legacy flow	Access Token / Session only	⚠️ RT-dependent features unavailable

Location: Registration Task Page or ChatGPT Platform Registration Dialog

ChatGPT Batch Operations

Available at the top of ChatGPT platform list:

• Status Sync
• Sync selected accounts' local status
• Sync selected accounts' CLIProxyAPI status

• Or batch execute on current filter results

• Re-upload Undiscovered

• Re-upload auth-file not found remotely
• Supports "current filter scope" or "currently selected accounts"

Delete Accounts

1. Navigate to Account Management page
2. Select accounts to delete (single or multiple selection)
3. Click Delete button to confirm deletion
4. Supports batch deletion of multiple selected accounts

One-Click Update

The project provides a quick update script to pull code, update dependencies, and restart the service in one go:

# Run in the project root directory
./update.sh

The script will automatically: 1. Stop the currently running service 2. Pull the latest code 3. Update Python dependencies 4. Update frontend dependencies and rebuild 5. Prompt whether to start the service

Note: The script uses Conda environment by default. If using venv, activate your environment first and manually perform the update steps.

---

📁 Project Structure

auto_reg/
├── api/                    # API routes
│   ├── accounts.py        # Account management APIs
│   ├── tasks.py           # Task management APIs
│   ├── platforms.py       # Platform APIs
│   ├── proxies.py         # Proxy management APIs
│   ├── config.py          # Configuration APIs
│   ├── actions.py         # Action APIs
│   └── integrations.py    # External integration APIs
├── core/                   # Core logic
│   ├── db.py              # Database initialization
│   ├── registry.py        # Platform registry
│   ├── scheduler.py       # Task scheduler
│   └── config_store.py    # Configuration storage
├── platforms/              # Platform plugins
│   ├── chatgpt/           # ChatGPT platform
│   ├── trae/              # Trae.ai platform
│   ├── cursor/            # Cursor platform
│   ├── kiro/              # Kiro platform
│   └── ...                # Other platforms
├── services/               # Service layer
│   ├── email_services/    # Email service implementations
│   ├── solver_manager.py  # Captcha solver management
│   └── chatgpt_sync.py    # ChatGPT sync service
├── frontend/               # Frontend code
│   ├── src/               # Source code
│   └── dist/              # Build artifacts
├── static/                 # Frontend build output
├── scripts/                # Utility scripts
├── docker/                 # Docker configuration
├── main.py                 # Entry point
├── requirements.txt        # Python dependencies
├── deploy.sh               # One-click deployment script
├── update.sh               # Quick update script
├── .env.example            # Configuration example
└── README.md               # Project documentation

---

📡 API Documentation

After starting the service, access http://localhost:8000/docs for interactive API documentation (Swagger UI).

Key Endpoints

Endpoint	Method	Description
/api/accounts	GET/POST	Account management
/api/tasks	GET/POST	Task management
/api/platforms	GET	List supported platforms
/api/proxies	GET/POST	Proxy management
/api/config	GET/PUT	Configuration management
/api/actions	POST	Execute actions
/api/integrations	GET/POST	External integrations
/api/solver/status	GET	Solver status
/api/solver/restart	POST	Restart solver

---

🔧 Troubleshooting

Turnstile Solver Not Running

Symptoms: Captcha verification fails, solver status shows offline

Solutions: 1. Check if backend is started correctly 2. Ensure running in correct Python environment (Conda env recommended) 3. Verify camoufox is installed: python -m camoufox fetch 4. Check solver logs in backend.log

Port Occupied

Symptoms: Service fails to start, port 8000 already in use

Solutions:

# Stop existing service
pkill -f "python main.py"

# Or find and kill specific process
lsof -i :8000
kill <PID>

# Restart service
python main.py

Email Service Failure

Symptoms: Cannot receive verification codes

Solutions: 1. Check proxy configuration and network connection 2. Some services require proxy access 3. Verify API keys are correct 4. Try alternative email service

Registration Disallowed (ChatGPT)

Error: registration_disallowed or HTTP 400

Solutions: 1.