Gemini Account AutoManager

English | 中文

A FastAPI + Vue 3 + Playwright/BitBrowser API automation system for batch Google account operations: account management, window management, 2FA setup/reset, eligibility verification, age verification, and card subscription binding.

Fork Notice: This project is a secondary development based on Leclee/auto_bitbrowser, with significant feature additions and bug fixes.

The system uses BitBrowser fingerprint browser and controls it via the local API (default 127.0.0.1:54345).

---

🚀 What's New (Compared to Original)

New Features

• Batch Delete by Status - Bulk delete accounts by specific status types
• Batch Password Change - Automated password modification workflow
• Eligibility Verification - Check student eligibility status
• 2FAGuard Export - One-click export 2FA secrets in 2FAGuard compatible format

Bug Fixes & Optimizations

• Fixed language detection logic in set_language.py - now checks actual page content instead of unreliable HTML lang attribute
• Improved business logic flow and error handling
• Enhanced stability for multi-account batch operations

---

✨ Features

• Web Management UI: Account management, search/filter, batch import/export, real-time logs & progress.
• Browser Window Management: Create, restore, sync, open/close windows.
• Task Orchestration: Execute tasks in order with configurable concurrency and real-time progress updates.
• 2FA Automation: Auto setup/reset 2FA and sync keys to browser config.
• Eligibility Verification: Auto extract SheerID links and verify eligibility, detect account status.
• Age Verification: Complete age verification using virtual cards.
• Card Binding: Handle multi-layer iframes to complete card binding and subscription.
• Multi-language Support: Auto switch account language to English to reduce failures.
• Unified Data: SQLite as single data source, auto sync historical text files.

🛠️ Installation & Usage

Requirements

• Python: 3.11+ (recommended 3.12)
• Node.js: 18+
• uv: Python environment manager
• BitBrowser: Installed locally with API accessible (default 127.0.0.1:54345)

Environment Setup

# 1) Install dependency tools
pip install uv

# 2) Create and sync Python dependencies (creates .venv)
uv sync

# 3) Install frontend dependencies
cd web/frontend
npm install

Option 1: Quick Start Web UI (Recommended)

./start_web.sh

After startup, access:

• Frontend: http://localhost:5173
• Backend API: http://localhost:8000
• API Docs: http://localhost:8000/docs

Option 2: Manual Start

# Backend
uv run python -m uvicorn web.backend.main:app --reload --port 8000

# Frontend
cd web/frontend
npm run dev

⚙️ Configuration

🔒 Security Note: The following config files contain sensitive information (passwords, 2FA keys, card numbers). Please ensure:

1. Do not commit to Git: These files are already in .gitignore
2. Keep safe: Recommend encrypted storage or password manager
3. Regular backup: Avoid data loss
4. Use example files: Refer to accounts_example.txt to create your own config

Web Config: You can fill in SheerID API Key and virtual card info in the Web UI "Config" page. The system will prioritize database config; only falls back to cards.txt if not configured.

1. accounts.txt (Account Info)

📌 Separator Configuration

Configure separator on the first line (uncomment one):

# Separator config (uncomment one line)
分隔符="----"
# 分隔符="---"
# 分隔符="|"
# 分隔符=","

📋 Account Format

Format (fixed field order): Email[Separator]Password[Separator]BackupEmail[Separator]2FASecret

# Standard format (using ---- separator)
分隔符="----"
example1@gmail.com----MyPassword123----backup1@email.com----ABCD1234EFGH5678
example2@gmail.com----P@ssw0rd!%%99----backup2@email.com----WXYZ9012STUV3456

# Email and password only (backup email and 2FA are optional)
example3@gmail.com----ComplexP@ss#2024

2. proxies.txt (Proxy IPs)

Supports Socks5/HTTP, one per line:

socks5://user:pass@host:port
http://user:pass@host:port

3. cards.txt (Virtual Card Info)

Format: CardNumber Month Year CVV (space separated)

5481087170529907 01 32 536
5481087143137903 01 32 749

4. Output Files (Auto Generated)

• accounts.db: SQLite database file
• sheerIDlink.txt: Successfully extracted verification links
• 已验证未绑卡.txt: Accounts verified but not yet bound with card
• 已绑卡号.txt: Accounts with completed card binding
• 无资格号.txt: Accounts detected as ineligible

📚 Documentation

See docs/ directory for complete technical documentation:

• Quick Start
• Architecture
• Configuration Guide
• Task System
• Browser Management
• Database Design

🙏 Credits

This project is based on:

• Leclee/auto_bitbrowser - Direct upstream
• 16627517673/bitbrowser-automation - Original project

Thanks to the original authors for the foundation work.

---

⚠️ Disclaimer

• This tool is for learning and technical exchange only. Do not use for illegal purposes.
• Please comply with BitBrowser and related platform terms of service.
• The developer is not responsible for any account loss or legal liability arising from the use of this tool.

📄 License

This project is licensed under the MIT License.