whatisgithub

What is szu-course-help?

weeye-hua/szu-course-help — explained in plain English

Analysis updated 2026-05-18

15PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A local tool for Shenzhen University students that automates logging into and selecting courses on the school system, with OCR auto-relogin and safety limits during lottery phases.

Mindmap

mindmap
  root((SZU-Course-Help))
    What it does
      Local course selection helper
      OCR auto relogin
      Blocks lottery-phase auto grab
    Tech stack
      Python
      FastAPI
      OCR ddddocr
    Use cases
      Automate course add drop phase
      Avoid manual captcha re-entry
      Track a pending course list
    Audience
      Students
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Automatically log back into the school course system when a session expires, using OCR to solve the captcha.

USE CASE 2

Track a pending list of courses and automatically try to enroll during the school's add or drop phase.

USE CASE 3

Avoid manually re-entering a captcha every time your session times out.

USE CASE 4

Run a ready-made release package on Windows, macOS, or Linux without setting up Python.

What is it built with?

PythonFastAPISQLiteOCR

How does it compare?

weeye-hua/szu-course-help0pen-sourcer/hearth13127905/deep-learning-based-air-gesture-text-recognition-
Stars151515
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/53/53/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a valid student login and, for source installs, Python 3.13, prebuilt releases avoid the Python setup step.

Free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

SZU Course Help is a local tool built for students at Shenzhen University to help them log into and use the school's online course selection system. It runs a small local web interface on your own computer, at an address like 127.0.0.1, rather than sending your data to any outside server. You log in manually the first time using your student ID, school password, and a captcha, and after that the tool can automatically detect when your session has expired and log back in on its own using optical character recognition, called OCR, to solve the captcha again. The tool includes a stage check that looks at what phase of course selection the school currently has open. If the school is in its lottery based preselection phase, the tool will not allow automatic course grabbing at all, since that phase is meant to be random. Automatic selection is only allowed during the school's regular add or drop phases, and only after the user confirms it. If the phase is unclear, not yet open, already closed, or cannot be confirmed with the school's own systems, automatic selection is blocked. When automatic selection is running, it takes turns submitting requests for each course you are trying to get into, rather than letting one course block all the others, and it will not add a class to your list if you are already enrolled in it or if it conflicts with your existing schedule. For people who do not want to set up Python themselves, the project publishes ready to run packages on its GitHub Releases page for Windows, macOS, and Linux, each including the program, its OCR dependencies, and a user guide, along with checksum files to verify the download has not been tampered with. Developers who want to run it from source need Python 3.13 and can install its dependencies with pip before running the program directly. The project also uses a local identity system called Card Key V3, built on cryptographic signatures, to issue a key tied to your student ID on your own machine, and it stores your school password only in memory during the current session rather than saving it to disk. The project is licensed under MIT.

Copy-paste prompts

Prompt 1
Walk me through downloading and running the right SZU-Course-Help release package for my operating system.
Prompt 2
Explain how this tool decides whether automatic course selection is currently allowed.
Prompt 3
Help me set up SZU-Course-Help from source using Python 3.13 and a virtual environment.
Prompt 4
Describe how Card Key V3 in this project ties a signed key to my student ID.

Frequently asked questions

What is szu-course-help?

A local tool for Shenzhen University students that automates logging into and selecting courses on the school system, with OCR auto-relogin and safety limits during lottery phases.

What language is szu-course-help written in?

Mainly Python. The stack also includes Python, FastAPI, SQLite.

What license does szu-course-help use?

Free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is szu-course-help to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is szu-course-help for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.