cmlonder/notebooklm-chunker

View on GitHub by @cmlonder

Heading-aware PDF chunking with resumable source and Studio workflows for turning long documents into interactive NotebookLM learning kits.

What's novel

Heading-aware PDF chunking with resumable source and Studio workflows for turning long documents into interactive NotebookLM learning kits.

Code Analysis

9 files read · 3 rounds

Splits long PDFs/documents into heading-aware chunks of configurable page size, uploads them to Google NotebookLM, and orchestrates Studio generation (reports, slides, quizzes, flashcards, audio) with resume, quota tracking, and Anki export.

Strengths

Genuinely sophisticated chunking algorithm with cost-based boundary selection that prefers chapter-level headings, multi-strategy PDF heading detection (TOC → font-size heuristic → text heuristic), and a complete async state machine for resumable multi-studio pipelines. The Anki .apkg builder from scratch using only stdlib is a notable engineering achievement.

Weaknesses

The NotebookLM uploader (101KB) is a single monolithic module that likely contains a lot of browser-automation glue, and the project's novelty is bounded by its dependency on the notebooklm-py library for the actual API interaction. The Electron desktop layer adds significant surface area (86 source files) that is mostly UI plumbing rather than core logic.

Score Breakdown

Innovation

5 (25%)

Craft

86 (35%)

Traction

25 (15%)

Scope

89 (25%)

Signal breakdown

Innovation

Not Fork+1

Code Novelty+1

Concept Novelty+2

Craft

Ci+5

Tests+8

Polish+5

Releases+5

Has License+5

Code Quality+26

Readme Quality+15

Recent Activity+7

Structure Quality+5

Commit Consistency+0

Has Dependency Mgmt+5

Traction

Forks+6

Stars+12

Hn Points+0

Watchers+0

Early Traction+5

Devto Reactions+0

Community Contribs+2

Scope

Commits+7

Languages+8

Subsystems+13

Bloat Penalty+0

Completeness+7

Contributors+6

Authored Files+15

Readme Code Match+3

Architecture Depth+7

Implementation Depth+8

Evidence

Commits

Contributors

Files

110

Active weeks

TestsCI/CDREADMELicenseContributing

Repository

Language

Python

Stars

Forks

License

MIT