1
🐍 Pre-flight: Python 3.10+
Antes de qualquer coisa: python3 --version. Se for < 3.10, instale antes (macOS default é 3.9, vai falhar silenciosamente).
Instalar Python 3.12
macOS (Homebrew):
brew install python@3.12
Linux (apt):
sudo apt update && sudo apt install -y python3.12 python3.12-venv
⚠️ Erro mais comum
"Instalei mas não funciona" — quase sempre é Python errado no PATH. Use command -v python3.12 pra confirmar.
2
📦 venv + notebooklm-py[browser]
Sempre use venv. Evita conflitos, evita "externally-managed-environment" no macOS.
PYTHON=$(command -v python3.12 || command -v python3.11 || command -v python3.10) $PYTHON -m venv ~/.notebooklm-venv source ~/.notebooklm-venv/bin/activate pip install "notebooklm-py[browser]" playwright install chromium
3
🔗 Symlink para ~/bin
Pra usar notebooklm em qualquer terminal sem ativar venv:
mkdir -p ~/bin ln -sf ~/.notebooklm-venv/bin/notebooklm ~/bin/notebooklm echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc # ou ~/.bashrc source ~/.zshrc notebooklm --help
4
🔑 Login custom via playwright
O comando padrão notebooklm login exige terminal interativo. Hermes/Claude Code não tem. Solução: script python que abre Chromium persistente, espera signal file.
📋 Fluxo
- Script roda em background, abre Chromium.
- Você loga no Google, navega até notebooklm.google.com.
- Confirma com
touch /tmp/nlm_save_signal. - Script captura cookies, salva em
~/.notebooklm/storage_state.json. notebooklm auth checkconfirma cookie SID presente.
5
📥 Instalar a skill no Hermes
Baixa o NotebookLMSkill.md, joga em ~/.hermes/skills/, diz pra Hermes "instala a skill notebooklm". Ele detecta, lê, fica pronto.
✓ Skill bem instalada
- ✓Arquivo .md no diretório correto
- ✓Frontmatter com name + description
- ✓Hermes confirma "skill carregada"
- ✓Test: "list my notebooks" funciona
✗ Comum dar errado
- ✗Frontmatter quebrado (YAML inválido)
- ✗Description vaga → não ativa
- ✗Notebooklm binary fora do PATH
- ✗Cookie expirado (precisa relogin)
6
🩺 Diagnóstico quando falha
Auth quebra? Tabela de sintoma → ação:
| Sintoma | Causa | Fix |
|---|---|---|
| auth check falha | Cookie SID ausente | Apagar browser_profile + relogin |
| "notebooklm: command not found" | Symlink quebrado ou PATH | Recriar ln -sf, source rc |
| "externally-managed-environment" | pip system-wide | Ativar venv antes de pip install |
| Browser não abre | Playwright não instalado | playwright install chromium |
| "Python version < 3.10" | Binário errado no PATH | Use $PYTHON explícito |
✅ Resumo do Módulo
✓
Python 3.10+ é mandatory
✓
venv isolado evita 90% dos erros
✓
Symlink torna o CLI global
✓
Login custom resolve falta de TTY
✓
Skill no Hermes ativa via description match
Próximo Módulo:
1.5 — ✅ Primeiros testes