Repolode
wuwangzhang1216

wuwangzhang1216/ChinaTextbookStudyFree

A free, open-source primary-school study platform covering grades 1-6 with unit quizzes, lesson explanations, read-along text and AI-generated stories.

Stars
918
Forks
251
Open issues
8
Last commit
2 days ago

What is it?

Chinese Study Free (聪聪学堂) is a free, non-commercial learning platform for Chinese primary school students from grade 1 to grade 6. It covers math (People's Education Press edition), Chinese (unified edition), English (PEP, grades 3-6) and science (Jiaoke edition), organized by textbook unit and lesson.

The platform offers unit quizzes with immediate feedback, knowledge explanations with text-to-speech narration, sentence-by-sentence textbook passage reading with recording playback, and AI-generated graded stories with reading comprehension questions and illustrations. Progress, mistakes and daily goals are stored in the browser; there are no accounts or cloud sync.

The Web version is a Next.js static site that can be deployed to any static host, and an SwiftUI iOS app is included with offline seed content. Large audio, image and textbook page assets are distributed through GitHub Releases and installed with a provided script.

Key features

  • 01Unit quizzes that follow textbook chapters, with immediate feedback and explanations
  • 02Sentence-by-sentence textbook passage reading with text-to-speech and read-along recording
  • 03TTS narration for questions, options, explanations and stories
  • 04AI-generated graded stories with reading comprehension questions and illustrations
  • 05Progress, mistake review and weekly reports stored locally in the browser
  • 06Static Web build plus a native SwiftUI iOS app

Use cases

  • Students who want extra practice aligned with their grade's textbook units
  • Parents at home supplementing school lessons without paid tutoring
  • Teachers or schools looking for a free base to review or adapt quiz content
  • Developers who want to self-host a static educational site for children

Quick start

  1. 1

    Clone the repository

    git clone --branch main https://github.com/wuwangzhang1216/ChinaTextbookStudyFree.git
  2. 2

    Enter the project folder

    cd ChinaTextbookStudyFree
  3. 3

    Download the resource files (about 2.06 GB)

    python3 scripts/install-release.py --tag v1.2.0-assets
  4. 4

    Install dependencies and start the web app, then open http://localhost:3000

    npm ci && npm run dev

Things to know

  • Requires Node.js 20+, Python 3.9+ and FFmpeg with libmp3lame, and about 2 GB of extra download plus disk space for resources.
  • Progress is saved only in the current browser; there are no cloud accounts or cross-device sync.
  • Speech recognition scoring is not available for read-along recordings.
  • Not all quiz questions have been reviewed by teachers, since the content is AI-generated.

Topics

FAQ

What is ChinaTextbookStudyFree?
A free, open-source primary-school study platform covering grades 1-6 with unit quizzes, lesson explanations, read-along text and AI-generated stories. Chinese Study Free (聪聪学堂) is a free, non-commercial learning platform for Chinese primary school students from grade 1 to grade 6. It covers math (People's Education Press edition), Chinese (unified edition), English (PEP, grades 3-6) and science (Jiaoke edition), organized by textbook unit and lesson.
Is ChinaTextbookStudyFree free to use? What license does it have?
ChinaTextbookStudyFree is open source under the MIT license. Check the license terms before using it in commercial products.
Is ChinaTextbookStudyFree still maintained?
Actively maintained. The last commit to ChinaTextbookStudyFree was on Oct 18, 2026.
What can I use ChinaTextbookStudyFree for?
Students who want extra practice aligned with their grade's textbook units Parents at home supplementing school lessons without paid tutoring Teachers or schools looking for a free base to review or adapt quiz content Developers who want to self-host a static educational site for children
How do I install ChinaTextbookStudyFree?
Clone the repository: git clone --branch main https://github.com/wuwangzhang1216/ChinaTextbookStudyFree.git Enter the project folder: cd ChinaTextbookStudyFree Download the resource files (about 2.06 GB): python3 scripts/install-release.py --tag v1.2.0-assets Install dependencies and start the web app, then open http://localhost:3000: npm ci && npm run dev
Where can I get ChinaTextbookStudyFree?
The source code and installation instructions are on GitHub: https://github.com/wuwangzhang1216/ChinaTextbookStudyFree

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects