# PastKing/tgbot-verify

一个基于 Python Telegram Bot 的自动化认证工具，能够自动完成 SheerID 平台的学生/教师身份验证流程。

Repository: https://github.com/PastKing/tgbot-verify
Canonical: https://ross.abutalabs.com/products/tgbot-verify
Language: Python
License: MIT
License Family: permissive
Last push: 2026-03-12T04:10:41+00:00

## Health v2 (maintenance only)
Score: 48/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 71, release rhythm 35, longevity 19
- inputs: {"age_days": 269, "days_push": 174, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3132, forks 982 (observed 2026-08-28T04:07:45.497843+00:00)

## What it is
A self-hosted Python Telegram bot that automates SheerID student/teacher identity verification flows for services like Spotify, ChatGPT, Gemini, Bolt.new, and YouTube Premium. It generates identity information and verification documents (PNG/PDF), submits them to SheerID, and includes a credits/user-management system backed by MySQL.

## Use cases
- automate SheerID student verification via Telegram
- auto-generate student or teacher ID documents for verification
- run a Telegram bot with a credits and invitation system
- self-host a verification bot with Docker and MySQL
- manage bot users, blacklists, and card-key redemptions

## When to choose
- you want a ready-made Telegram bot for automating multi-step web verification flows
- you need a self-hosted bot with user management, credits, and admin commands
- you want a Python codebase combining python-telegram-bot, Playwright, and document generation

## When to avoid
- you need a legitimate or authorized identity-verification solution - this tool fabricates credentials and its use likely violates SheerID's and downstream services' terms of service and may be illegal
- you need a general-purpose Telegram bot framework rather than this specific verification workflow
- you cannot maintain the frequently changing programId configurations it depends on

## Facets
- artifact type: application
- maturity: active
- function: chatbot, workflow-automation, image-processing, web-scraping
- domain: chatbots, developer-tools
- platform: python, self-hosted
- tags: telegram-bot, sheerid, student-verification, teacher-verification, python-telegram-bot, playwright, credits-system, self-hosted-bot, automation, docker, telegram

## Member repositories
- PastKing/tgbot-verify (main) score 48

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:45.497843+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:26:08.157419+00:00, confidence not recorded.
  - readme: https://github.com/PastKing/tgbot-verify (fetched 2026-08-28T04:07:45.497843+00:00, sha b57297f3c22c)
- Data as of 2026-08-30T08:39:29.467469+00:00.