notebooklm

Featured

Install, authenticate, troubleshoot, and operate Gemini Notebook through the notebooklm-py CLI or typed async Python API. Use for notebook and source management, grounded chat and research, and artifact generation or download when the user mentions Gemini Notebook, notebooklm-py, the notebooklm CLI, or its Python API. Do not use for the generic Gemini API or unrelated content creation.

AI & Automation 20,277 stars 2692 forks Updated today MIT

Install

View on GitHub

Quality Score: 93/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Gemini Notebook Automation Use the `notebooklm` CLI for agent workflows. Prefer `--json` and explicit IDs so every operation is inspectable and safe under concurrency. Use the typed async Python API only when the user requests application code or the CLI cannot express the workflow. The readiness, identity, authorization, and credential-handling rules below apply to both interfaces. ## Setup and Authentication Requires Python 3.10+. Install the package in the user's existing environment; do not create a separate environment unless requested: ```bash pip install "notebooklm-py[browser]" pip install "notebooklm-py[cookies]" # optional browser-cookie extraction ``` If system `pip` reports `externally-managed-environment`, do not use `--break-system-packages`. For CLI-only use, offer `uv tool install "notebooklm-py[browser]"` or the equivalent `pipx` command; for application code, use the user's active project environment. For unattended or headless work, prefer durable profile-backed master-token auth over a copied cookie snapshot. Install `pip install "notebooklm-py[headless]"`; the one-time automatic OAuth capture also needs `[browser]`. On a trusted workstation run `notebooklm login --master-token --account <email>`, then deploy `master_token.json`, not `storage_state.json`, to the selected profile. `NOTEBOOKLM_HOME` selects the private base directory and `NOTEBOOKLM_PROFILE` selects its profile; defaults resolve to `~/.notebooklm/profiles/default/master_token.json`....

Details

Author
teng-lin
Repository
teng-lin/notebooklm-py
Created
10 months ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category