explaingit

jerryxugit-2026/ziyang-vocab-master

Analysis updated 2026-05-18

31HTMLAudience · generalComplexity · 1/5Setup · easy

TLDR

A free single-file browser tool that turns any PDF into an AI-enriched vocabulary list with flashcard review.

Mindmap

mindmap
  root((Ziyang Vocab Master))
    What it does
      Extracts words from a PDF
      AI enriches definitions
      Flashcard review
    Tech stack
      Single HTML file
      Google Gemini API
      Pexels images
    Use cases
      Build a vocab list from a textbook
      Study for GRE or SAT
      Practice with flashcards
    Audience
      Students
      Beginners

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

Drop in a PDF textbook or handout to automatically extract its vocabulary words.

USE CASE 2

Provide a Google Gemini API key to auto-fill definitions, synonyms, and example sentences for each word.

USE CASE 3

Study with flashcards that test recall, recognition, spelling, and spoken pronunciation.

USE CASE 4

Export the extracted word list as a spreadsheet for use elsewhere.

What is it built with?

HTMLJavaScriptGoogle Gemini API

How does it compare?

jerryxugit-2026/ziyang-vocab-mastercxq0517/htmltool2echosoar/local-trans
Stars313131
LanguageHTMLHTMLHTML
Setup difficultyeasyeasymoderate
Complexity1/51/52/5
Audiencegeneralvibe coderdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Runs as a single HTML file with no server or account, a Google Gemini API key is only needed for the AI enrichment step.

Open source and free to use with no commercial intent stated by the author, check the repository for the exact license terms.

In plain English

Ziyang Vocab Master is a free vocabulary study tool created by a tenth-grade high school student in Beijing. The motivation is practical: most vocabulary apps force users to work from pre-built word lists, but students preparing for exams like the GRE or SAT, or studying from specific textbooks and teacher handouts, need to study their own custom lists. This tool lets you build a vocabulary database from any PDF you already have. The application is a single HTML file that runs entirely in your browser. No server, no account, and no installation are needed. All data stays on your own computer. It works in three steps. The first is a PDF extractor: you drop in a PDF and the tool automatically pulls out vocabulary words while filtering out common filler words like the and and. The resulting list can be exported as a spreadsheet. The second step is an AI enrichment stage: you provide a Google Gemini API key and the tool fills in each word's pronunciation in phonetic notation, its definition, word roots, synonyms, antonyms, and example sentences. It also fetches images from Pexels to give each word a visual memory aid. The third step is a flashcard review session. Cards cycle through four challenge types: recalling the word from a context clue, recognizing it in a sentence, spelling it correctly from memory, and speaking it aloud through a microphone. On macOS, right-clicking a word can open the system dictionary directly. The project is open source and free to use with no commercial intent. The author notes plans to add support for Korean, Ukrainian, Russian, Japanese, and Spanish in the future.

Copy-paste prompts

Prompt 1
Show me how to open Ziyang Vocab Master and extract vocabulary from my own PDF.
Prompt 2
Explain what a Google Gemini API key does in Ziyang Vocab Master and how to add one.
Prompt 3
Walk me through the four flashcard challenge types in Ziyang Vocab Master.
Prompt 4
Help me export my extracted vocabulary list from Ziyang Vocab Master as a spreadsheet.

Frequently asked questions

What is ziyang-vocab-master?

A free single-file browser tool that turns any PDF into an AI-enriched vocabulary list with flashcard review.

What language is ziyang-vocab-master written in?

Mainly HTML. The stack also includes HTML, JavaScript, Google Gemini API.

What license does ziyang-vocab-master use?

Open source and free to use with no commercial intent stated by the author, check the repository for the exact license terms.

How hard is ziyang-vocab-master to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ziyang-vocab-master for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.