mrkeyoor.com_
Thu 10 Sept 03:01 UTC
Dataevaluationupdated 10 Sept 2026

zju-icicles review

QSCTech/zju-icicles is a Chinese-language, crowd-sourced archive of course materials for Zhejiang University, mainly computer science. The README and most repository content are in Chinese, and there is no English documentation. It solves the scattered, word-of-mouth problem of university course intelligence: past exams, notes, homework answers, A4 cheat sheets, and course reviews become a browsable GitHub repo.

trackingstars / 7d
Verdict

Our run cloned 6,979.5 MB and installed 58 Python packages in 25 seconds, then a generic build failed in 5 seconds, but that failure is irrelevant because this repo is a document archive, not software. If you are a ZJU student, use it without hesitation; if you are not, steal its directory-and-README model for your own university.

We ran it

Install✓ · 25s58 packages · 60 MB
Build✗ · 5s
Testsn/ano test script
Known vulns0(pip-audit)
Repo4731 files~27,631 lines of source · 6979.5 MB · 1 CI workflows

Answers from our run

Does zju-icicles build from source?

Dependencies installed in 25 seconds (58 packages), and the build failed. We cloned commit ed653c6 into a clean Debian container with 3 CPUs and no project-specific setup.

Does zju-icicles have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does zju-icicles have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use zju-icicles?

People who do not read Chinese, since the README and folder guides are Chinese-only

What are the alternatives to zju-icicles?

libpku, REKCARC-TSC-UHT, USTC-Course. Our run cloned 6,979.

Setup3/5No app to run, but full clone is 6.98 GB and generic build failed
Docs3/5Detailed Chinese contributor guide, but no English docs
Community4/541k stars, active push 3 days ago, only 11 open issues
Maturity4/510 years of accumulated material and active maintenance

Who it’s for

Zhejiang University students, especially CS majors, who want course materials and selection advice
Incoming ZJU students planning electives or looking for past exams
Students at other universities studying how to build a similar course resource repo
Contributors who want to share notes, past papers, or review materials in Chinese

Who it’s NOT for

People who do not read Chinese, since the README and folder guides are Chinese-only
Developers looking for installable software or an application to build and run
Users with very limited bandwidth, since a full clone is 6,979.5 MB
People needing a formally licensed open-source project, since the repo license is unknown

Setup reality

When we ran it on 2026-09-09, the harness saw a Python ecosystem surface and ran a package install, which succeeded in 25 seconds with 58 packages installed and 60 MB on disk. The following generic build failed in 5 seconds with exit code 1, and there was no project-specific error in the log beyond that exit code. The README never mentions a build step, and this repository is not an application: it is a collection of documents, PDFs, and markdown. There is no tests script or tests directory, so tests were skipped. For actual use, you do not install or build it; you browse the repo or fork it and upload files through the GitHub web interface as the README describes.

QSCTech/zju-icicles (浙江大学的“课程攻略共享计划”) is a Chinese-language, crowd-sourced archive of course materials for Zhejiang University, mainly computer science. The README and most repository content are in Chinese, and there is no English documentation. It solves a real, unglamorous problem: course intelligence at a university is scattered across WeChat/QQ groups, CC98 forums, and a senior's USB stick. This project turns those hidden notes, past exams, homework answers, and A4 cheat sheets into a browsable GitHub repo with folders and README files per course.

The repository is large: at commit ed653c6, it held 4,731 files and 6,979.5 MB checked out, with roughly 27,631 lines of source recognized by our tooling. The project began in 2016 and now has 41,023 stars, which is huge for this category. The last push was 2026-09-07, three days before this review, so it is still actively maintained. There are 11 open issues, a low number for a repo of this size and age, which suggests maintainers either triage quickly or contributors are not filing many tickets.

What happened when we ran it

Because the measurement harness saw a Python ecosystem surface, it attempted a package install and then a build. In our run on 2026-09-09, the install succeeded in 25 seconds, installing 58 packages and using 60 MB on disk. There were 0 known vulnerabilities from pip-audit. The build then failed in 5 seconds with exit code 1. The README never mentions a build step, and the repo is not an application you compile or run; it is a collection of documents, PDFs, and markdown. A packaging build has no valid target in a repository whose main content is course material. We did not see a project-specific error in the log beyond the exit code, and we will not guess at a cause the log does not show. There is no tests script or tests directory, so the harness skipped tests. The repository has one CI workflow file, no Dockerfile, and no tests directory. In short, do not judge this project by build status; judge it by whether you can find the material you need.

For a contributor, the real setup is not a build. It is forking the repo and uploading files through GitHub's web interface. The README walks through that flow in Chinese, including a trick for creating a new folder by editing the browser address bar. The project's large size, 6,979.5 MB, makes a full local clone heavy; the web flow is the intended path for most people.

Strengths

The strongest part of this project is its directory convention. Each course gets a folder, and each folder can display a README alongside its files, so someone browsing GitHub sees course introductions and selection advice next to the PDFs and notes. The README explicitly requests contributions for selection guides, electronic textbooks, homework answers, past exams, review material, and open-book exam A4 sheets. It says the project already covers most computer science courses. It also has a clear policy about what not to upload: pirated ebooks, cracked paid software, and instructor-published course pages. That policy reduces copyright risk and keeps the repository on the right side of GitHub's rules.

The documentation for contributors is unusually practical. It warns that a contributor's fork can drift dozens or hundreds of commits from upstream, and offers two solutions: delete and re-fork if you are not comfortable with git, or rebase if you are. That kind of detail is exactly what prevents novice contributors from getting stuck. The project also asks reviewers to use pinyin initials for teacher names, which is a thoughtful privacy convention from the Chinese university context.

Another strength is the longevity and community pull. Ten years of accumulated material is not something a single person curates; it is a living archive maintained by generations of ZJU students. The 41,023 stars are not a vanity metric here: they signal trust and discoverability for incoming students. Active pushes three days before this review, with only 11 open issues, mean the repository is not a museum.

Weaknesses and rough edges

The biggest weakness is discoverability outside the target audience. The entire README is in Chinese, and there is no English README or translation. If you do not read Chinese, you can still browse file names and PDFs, but the selection advice and folder READMEs will be inaccessible. The repository license is listed as unknown by GitHub; the README licenses contributed text under CC-BY-NC-SA, but other materials belong to their original authors. That split license is normal for course archives but means you should not treat the repo as cleanly open source for commercial use.

The build failure we measured is not a product bug, but it will confuse anyone who expects a Python package. The repo includes a Python packaging surface according to our harness, yet the generic build exited 1 after 5 seconds. A curious user who runs pip install . or a build tool will get a failure and no guidance in the README. If the maintainers want to avoid that confusion, they could mark the repository as a documentation/resource project or add a stub build target, but that may be out of scope.

The repo is also enormous at 6,979.5 MB. That is mostly course PDFs and archives, unavoidable for this purpose, but it makes local clones and forks slow for people with limited bandwidth. The recommended web upload flow avoids local cloning, but then contributors cannot preview the full tree locally. The absence of a Dockerfile or tests is not a problem for this kind of project, but it is a limitation if you want to run any kind of validation on filenames or broken links before merging PRs.

Community health and release cadence

There are no releases, and that is fine for this project: it does not ship versioned software. The last push was 2026-09-07, three days before this review, showing active maintenance. With 11 open issues on a 41,023-star repo, the issue tracker is quiet, likely because usage does not require support. The single CI workflow file suggests some automation exists, but we did not run it and the README does not describe it. Overall, the community is alive and the project is being touched often enough to trust that new materials are accepted.

Where this fits in a real stack

This project is not software you deploy; it is a reference layer for students. It fits before or beside a university's official LMS, not in front of it. A student would use it at the start of a semester to read course reviews and download past exams, then consult it before finals for A4 sheets and homework answers. Contributors add material after a course ends. It does not replace Canvas, Moodle, or any institutional system; it complements them by preserving what official systems often delete after the term.

If you are not a Zhejiang University student, the most useful thing may be the model itself: a git-based, folder-first, contribution-friendly approach to course resource sharing. Several universities have built similar repos, and the ones below are worth checking for your own school.

Alternatives

ProjectWhat it isPick it when
libpkuPeking University course resources curated by students, with similar materials but for PKU.You study at Peking University or want the PKU curriculum stack instead of ZJU.
REKCARC-TSC-UHTTsinghua CS course guides and materials, widely starred and structured by course.You need Tsinghua CS-specific course selection guidance and materials.
USTC-CourseUniversity of Science and Technology of China course resources, including notes and exam archives.You attend USTC or want USTC course references.

What people are saying

  1. [velocity-scout] QSCTech/zju-icicles

Sources

  1. QSCTech/zju-icicles GitHub repository
  2. zju-icicles homepage

More data reviews

matplotlib · awesome-datascience · quickwit · mongoose · faiss · domain-list-community · the whole board →