explaingit

jz-zzzz/k12-driver

Analysis updated 2026-05-18

12TypeScriptAudience · developerSetup · moderate

TLDR

A locally run tool that manages ChatGPT K12 education workspace sessions, including joining workspaces and converting sessions into configuration JSON.

Mindmap

mindmap
  root((repo))
    What it does
      Manages ChatGPT K12 sessions
      Sends workspace join requests
      Converts sessions to JSON
    Tech stack
      Go backend
      React and Vite frontend
      Local-only server
    Use cases
      Workspace pool management
      Session format conversion
      Region precheck
    Audience
      Developers
      ChatGPT power users

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

Send a join request to a pool of workspace identifiers using a pasted ChatGPT session.

USE CASE 2

Convert an education-tier K12 ChatGPT session into Sub2API or CPA configuration JSON.

USE CASE 3

Check your outgoing network region before sending a join request to avoid region mismatches.

USE CASE 4

Run entirely locally with a Go backend that never writes session data to disk.

What is it built with?

TypeScriptGoReactVite

How does it compare?

jz-zzzz/k12-driveralamops/agetoraza-ali/blendpixel.com
Stars121212
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity4/52/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Session data contains sensitive access tokens, run only on a trusted local machine, per the README's own warning.

In plain English

k12-driver is a small locally run tool for managing ChatGPT accounts that have access to OpenAI's K12 education program. After you paste in the full session data for a ChatGPT account, the tool can do two different things with it, depending on what kind of account it is. For a regular free ChatGPT account, it can send a request asking that account to join one or more workspaces from a saved list of workspace identifiers, which the README describes as K12 spaces. Each workspace is described as having its own separate usage quota, and the tool checks your computer's outgoing network region before sending a join request, so a mismatch with the workspace's expected region does not silently fail without warning. For an account that already has education level K12 access, the tool can convert its session information into a different format, described as Sub2API or CPA JSON, which can then be copied or downloaded. The typical flow is to open ChatGPT's own session information page in a browser, copy the full session data shown there, and paste it into k12-driver's interface. From there you manage a list of workspace identifiers, choose which ones to send a join request to, and after switching workspaces in ChatGPT itself, you copy the refreshed session data back into the tool to generate the converted configuration file. Technically the project has a Go based backend server and a React and Vite based frontend. The backend only sends network requests on your behalf, it does not save session data to a database or to disk. However, the browser interface does keep whatever you typed in local browser storage so it persists across page refreshes, and the list of workspace identifiers is stored the same way. The README includes a warning that session data contains sensitive access tokens and should only be used on a computer you trust.

Copy-paste prompts

Prompt 1
Help me build the Go backend and React frontend for k12-driver and run it locally.
Prompt 2
Explain what the Workspace UUID pool does and how join requests are sent.
Prompt 3
Walk me through converting a K12 ChatGPT session into Sub2API JSON with this tool.
Prompt 4
What data does k12-driver store in browser localStorage versus on the server?

Frequently asked questions

What is k12-driver?

A locally run tool that manages ChatGPT K12 education workspace sessions, including joining workspaces and converting sessions into configuration JSON.

What language is k12-driver written in?

Mainly TypeScript. The stack also includes TypeScript, Go, React.

How hard is k12-driver to set up?

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

Who is k12-driver for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.