Mapa da trilha
Conteúdo detalhado
🪶 O que é Hermes Agent
Agente pessoal que vive no Telegram, conhece você e melhora a cada conversa.
Hermes é um agente AI que roda na sua máquina (Mac/Linux) e responde via Telegram. Sem app extra, sem aprender ferramenta nova — você só conversa.
Telegram está no seu bolso 24/7. Pode pedir algo no ônibus, no banheiro, na esteira. Resposta chega sem você abrir laptop.
Interface assíncrona · execução local · bot único · contexto persistente entre mensagens.
Arquivo `~/.hermes/soul.md` que descreve você: identidade, missão, voz, ritmo, pessoas, ferramentas. Carregado em toda task.
Sem soul.md, Hermes é um chatbot genérico. Com soul.md, ele é SEU chefe de gabinete. Quanto mais específico, mais útil.
Identidade · pilares anuais · voz e tom · ritmo de trabalho · decisões já tomadas · hard nos.
Arquivos `.md` com instruções específicas. Quando o pedido casa com a descrição, Hermes carrega aquela skill. NotebookLM é uma skill.
Você não precisa programar. Baixa o `.md`, joga na pasta, pronto. Habilidade nova sem código.
Discovery automático · ativação por intenção · isolamento (skill não polui contexto principal) · composição (várias skills no mesmo pedido).
Sistema de arquivos onde Hermes guarda fatos sobre você, feedbacks de correção, contexto de projetos. Carregado em sessões futuras.
Você não repete instruções. Disse uma vez "nunca uses menu interativo" — ele lembra para sempre.
Tipos (user, feedback, project, reference) · MEMORY.md como índice · evolução vs duplicação.
Hermes não só responde texto: lê arquivos, edita código, dispara comandos, faz HTTP, consulta APIs. Toda ação real passa por uma tool.
É a diferença entre "ChatGPT que sugere" e "agente que executa". Hermes resolve, não opina.
Read/Write/Edit · Bash · WebFetch · MCP (servers externos) · permissões e modos de execução.
Hermes = camada de orquestração via Telegram. Claude Code = mesma engine, terminal. ChatGPT = chat puro, sem tools locais.
Não é tribalismo. É saber escolher: trabalho profundo → Claude Code. Mobilidade → Hermes. Brainstorm rápido → ChatGPT.
Mesma memória entre Hermes e Claude Code · skill compartilhada · networked memory.
🧠 O que é NotebookLM
A plataforma de pesquisa #1 do mundo. Grátis. Cita tudo. Cabe 300 fontes.
Cada notebook agrupa até ~300 fontes (PDFs, sites, YouTube, áudios, imagens). Tudo indexado. Você pergunta, NotebookLM responde citando trechos exatos.
É um RAG industrial sem você precisar montar vetor DB, pagar OpenAI, ou ajustar chunking.
Source · grounding · citação inline · isolamento por notebook.
Geração automática de podcast com 2 vozes debatendo as fontes. ~12-20 min de áudio natural com transições e perguntas.
Você consome conteúdo enquanto dirige, treina, lava louça. Conhecimento entra pelo ouvido.
Format (deep-dive, brief, critique, debate) · length · instruções customizáveis · download MP3.
Vídeo explainer narrado com visuais (estilos: clássico, whiteboard, anime, watercolor...). Slide deck em PDF/PPTX, pronto para apresentar.
Você termina uma reunião, pede um deck baseado nas notas — sai em minutos pronto.
Style · format detailed/presenter · revise-slide para iterar por slide individual.
Mind map (.json), infográfico (.png landscape/portrait), report (briefing-doc, study-guide, blog-post), data table (.csv), quiz e flashcards.
Mesma fonte, formato diferente. Você reaproveita pesquisa de 10 jeitos sem refazer trabalho.
Artifact list · status (in_progress/pending/completed) · download multi-formato.
`source add-research "query"` faz pesquisa na web (modo fast ou deep) e importa o resultado como fonte do notebook.
Você não precisa abrir 50 abas e copiar. NotebookLM colhe, sintetiza, indexa.
Mode fast vs deep · research status/wait · import-all.
Google subsidia. Você usa conta gratuita Google e tem acesso ilimitado (com rate limits). Custo de inferência fica com eles.
Saber os limites evita surpresa. Geração de áudio/vídeo pode dar throttle em horário de pico.
Rate limit · tempo de geração (áudio 10-20min, vídeo 15-45min) · retry automático.
⚡ Por que combinar Hermes + NotebookLM
A diferença entre "ler uma resposta" e "transformar resposta em ação".
Hermes te dá execução (envia email, agenda, cria workflow). NotebookLM te dá pesquisa profunda com citação. Junte: agente que sabe E age.
É a vantagem competitiva real. Quem só usa um dos dois fica anos atrás.
Pesquisa → ação · loop fechado · linguagem natural ponta a ponta.
NotebookLM tem app web e mobile, mas é navegação manual. Hermes te dá um endpoint conversacional — você manda voz da academia, ele despacha pra NotebookLM.
Ideia surge no transporte público, no almoço, no chuveiro. Capturar na hora multiplica o output.
Telegram client universal · sincronia chat ↔ notebook · captura assíncrona.
Um notebook permanente ("AI Brain") onde você empilha resumos de sessões. Hermes consulta antes de responder qualquer pergunta sobre seus projetos.
Você nunca mais perde contexto entre conversas. Tudo o que aprendeu fica recuperável.
Wrapup pattern · second brain · ground-before-answer · skill instruction.
"Toda manhã 8h, gera podcast de 5 min com insight do meu AI Brain e manda no chat." Você programa uma vez via cron. Forever.
Rotina cognitiva sem esforço. Como ter assistente que prepara briefing diário.
Cron via Hermes · n8n schedule trigger · audio overview agendado.
Montar RAG próprio: Pinecone ($70+), OpenAI embeddings ($), GPT-4 queries ($$). NotebookLM: $0. Google paga.
Você roda 300 fontes por notebook, faz perguntas o dia inteiro, custo permanece zero. Não tem competição.
Custo zero de inferência · upper bound de uso · alternativas pagas (Mem, Pinecone+LangChain).
YouTube strategy, e-commerce research, monitor de competidores, estudo técnico, briefing de cliente, preparação de aula.
Aterriza o conceito. Você vê onde aplicar na sua vida amanhã de manhã.
Por domínio · padrão "criar notebook por área" · não misturar contextos.
🔧 Instalação e setup
Python 3.10+, venv, playwright, login persistente e symlink para PATH global.
Checagem `python3 --version`. Se for 3.9 (macOS Apple default), instalar 3.12 via Homebrew. Linux: apt python3.12.
É o erro mais comum em setup. notebooklm-py exige 3.10+ ou quebra silenciosamente.
Binário correto · path no /opt/homebrew/ vs /usr/local · resolução com command -v.
`python3 -m venv ~/.notebooklm-venv` → `pip install "notebooklm-py[browser]"` → `playwright install chromium`. Tudo em uma venv dedicada.
Evita erro "externally-managed-environment" e conflito com outras lib system-wide.
Activate · pip install extras · playwright como dependência browser.
`ln -sf ~/.notebooklm-venv/bin/notebooklm ~/bin/notebooklm` e adicionar `~/bin` no PATH do shell rc.
Sem isso, você precisa ativar a venv antes de cada uso. Symlink resolve.
Symbolic link · PATH precedência · ln -sf (force replace).
Script python que abre Chromium persistente, espera você logar no Google e navegar até notebooklm.google.com, depois salva `storage_state.json`.
O comando padrão exige terminal interativo. Claude Code/Hermes não tem. Solução: signal file.
Persistent context · cookie SID · signal via touch file · captura assíncrona da sessão.
Baixar `NotebookLMSkill.md`, jogar no diretório de skills e dizer "instala a skill notebooklm". Hermes pede reautenticação se cookie faltou.
É a ponte entre você e a CLI. Sem skill, Hermes não sabe que pode usar `notebooklm`.
Skill description (triggers) · system prompt · auto-discovery · autonomy rules (quais comandos confirmam).
`notebooklm auth check` → procura cookie SID. Falhou? Apagar `~/.notebooklm/browser_profile` e refazer login.
Cookies expiram, Google rotaciona token. Saber o ciclo te poupa horas.
storage_state.json · cookie SID · re-auth seamless · logs em /tmp.
✅ Primeiros testes — validando ponta a ponta
Listar, criar, adicionar fonte, perguntar e gerar artefato. Se tudo passa, sistema OK.
Comando inicial. Retorna lista de notebooks com id, título, data. Confirma auth + conectividade.
Se falhar aqui, todo o resto falha. É o ping da skill.
Comando read-only · seguro pra rodar sem confirmação · output JSON com --json.
Cria notebook vazio com o título "Sandbox". Retorna id (usar nos próximos comandos).
Trabalhe num notebook descartável até dominar o fluxo. Não suje o AI Brain.
Notebook id · title (busca exata) · auto-uso após criar.
`notebooklm source add "https://..."` envia URL. Processo demora 30s-2min. `source list --json` confirma status=READY.
É a base de tudo. Sem fonte, sem RAG, sem resposta útil.
URL, YouTube, PDF local, áudio, imagem · estado PROCESSING → READY · wait blocker.
Faz query no contexto do notebook atual. Resposta cita as fontes inline. Adicionar `--json` traz referências estruturadas.
É a interação core. Tudo orbita em torno do ask.
RAG query · grounding · `--save-as-note` para fixar como nota · -s para limitar fontes.
`notebooklm generate mind-map` é síncrono e rápido. Bom teste antes de gastar 15min num podcast.
Confirma que a engine de geração tá funcional. Se mind-map passa, áudio/vídeo provavelmente passam.
artifact list · status · download (.json para mind-map).
"Hermes, lista meus notebooks." Resposta volta no chat. Confirma toda a stack: Telegram → Hermes → skill → notebooklm CLI → Google.
Tudo passou. Você está oficialmente no clube.
Cadeia ponta-a-ponta · onde olhar quando falha · logs de Hermes vs logs do CLI.