k12-reg  by lxh77721

Automated K12 workspace integration and account management console

Created 1 week ago

New!

383 stars

Top 74.2% on SourcePulse

GitHubView on GitHub
Project Summary

A local, multi-threaded console application designed to automate the registration and management of K12 workspace accounts. It targets users needing to handle numerous accounts efficiently, offering features like email pool management, dynamic email verification, Sub2API integration, and account data export. The project serves as an open-source technical example for local automation.

How It Works

This project utilizes a Node.js backend with a web-based console for user interaction. It employs a multi-threaded architecture to manage concurrent tasks, including importing and managing email pools, integrating with various email verification services (like SMSBower and Emailnator for Gmail), and automating the K12 workspace joining process. Key functionalities extend to Sub2API integration for OAuth and direct data import, account health checks, and data migration. A notable architectural choice is the SaaS multi-user mode, which isolates user configurations and data using tenant IDs, preventing data overlap in shared deployments.

Quick Start & Requirements

  • Installation: Run npm install.
  • Execution: Execute npm run dev for development. A production build is available via npm run build.
  • Prerequisites: Node.js 20+ (22+ recommended), npm 10+, and a network environment accessible to relevant services. HTTP/SOCKS proxies can be configured.
  • Access: Web console available at http://127.0.0.1:5174/, API service at http://127.0.0.1:8796/.

Highlighted Details

  • Comprehensive email pool management: import, select, delete, and mark email statuses.
  • Supports multiple dynamic Gmail verification methods: SMSBower and Emailnator.
  • Sub2API integration includes OAuth, noRT direct import, account activation testing, and Access Token (AT) fixing.
  • Account data can be exported in SUB2API or CPA JSON formats.
  • Task management features allow batch operations, retries, log viewing, and failure cleanup.
  • SaaS multi-user mode provides tenant-level data isolation for configurations and task history.

Maintenance & Community

The project welcomes issues and pull requests from the community. A "GPT K12 Console Learning Exchange Group" is mentioned, suggesting an active user community, though direct links are not provided.

Licensing & Compatibility

The project is released under the MIT License, permitting free use, modification, and distribution, including for commercial purposes, provided the original copyright and license notices are retained.

Limitations & Caveats

The project is presented as an "as-is" example for technical research and local automation. Users must independently assess the legality and compliance of their usage, as automated actions may violate third-party service terms or local regulations. Risks include potential service rule changes, triggering risk controls, data leakage from third-party services, and compromise of locally stored sensitive data (tokens, cookies, JSON). The authors disclaim responsibility for any usage outcomes, including account losses or service bans.

Health Check
Last Commit

1 week ago

Responsiveness

Inactive

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

Explore Similar Projects

Feedback? Help us improve.