7d95531dc1
Create grounded knowledge base with Audio Overview capabilities for hand-friendly review and knowledge synthesis. ✅ Task Documentation Created: - README.md: Complete overview, use cases, benefits - setup-guide.md: Step-by-step setup and testing 🎧 KEY FEATURES: - Audio Overviews (listen instead of reading - hand-friendly) - Grounded research (only YOUR sources, no hallucination) - MCP integration (Claude queries notebooks seamlessly) - Meg accessibility (technical content in audio format) - Legacy preservation (for children not yet born) 📚 USE CASES: - Infrastructure knowledge base (835+ docs queryable) - Chronicler lineage archive (all memorials in audio) - Pokerole project docs (session reports accessible) - Training for Meg (technical content via audio) 💰 COST: FREE (Google NotebookLM, MCP in Max plan) ⏱️ TIME: 1-2 hours setup, 15 min/week maintenance 🎯 VALUE: HIGH for accessibility + knowledge retention Inspired by: XDA article on Claude + NotebookLM workflow Priority: Medium (HIGH for accessibility needs) Task #36 ready to start when Michael is ready.
443 lines
10 KiB
Markdown
443 lines
10 KiB
Markdown
# NotebookLM Integration - Setup Guide
|
|
|
|
**Task:** #36 - NotebookLM Integration
|
|
**Time:** 1-2 hours
|
|
**Difficulty:** Easy
|
|
**Accessibility:** HIGH (designed for hand-friendly workflow)
|
|
|
|
---
|
|
|
|
## Phase 1: Initial Setup (15 minutes)
|
|
|
|
### Step 1: Access NotebookLM
|
|
|
|
**Navigate to:**
|
|
```
|
|
https://notebooklm.google.com
|
|
```
|
|
|
|
**Sign in:**
|
|
- Use your existing Google account
|
|
- No special permissions needed
|
|
- Free service, no credit card
|
|
|
|
**Expected:** Welcome screen with option to create first notebook
|
|
|
|
---
|
|
|
|
### Step 2: Create First Test Notebook
|
|
|
|
**Click:** "New Notebook" or "+ Create"
|
|
|
|
**Name it:** "Firefrost Infrastructure - Test"
|
|
|
|
**Purpose:** Testing the workflow before committing to full setup
|
|
|
|
---
|
|
|
|
### Step 3: Upload Test Documents
|
|
|
|
**Start small - upload these 5 documents:**
|
|
|
|
1. `infrastructure-manifest.md` (current infrastructure state)
|
|
2. `SESSION-HANDOFF-PROTOCOL.md` (latest session context)
|
|
3. `POKEROLE-WIKI-MISSION-SUCCESS.md` (recent major achievement)
|
|
4. Latest Chronicler memorial (e.g., chronicler-26-the-investigator.md)
|
|
5. One FFG-STD document (e.g., FFG-STD-001)
|
|
|
|
**How to upload:**
|
|
- Click "+ Sources" or "Add Source"
|
|
- Select "Upload" from computer
|
|
- Navigate to your local Git clone
|
|
- Select files
|
|
- Wait for processing (30 seconds - 2 minutes per file)
|
|
|
|
**Expected:** Files appear in Sources panel with checkmarks when processed
|
|
|
|
---
|
|
|
|
### Step 4: Test Basic Queries
|
|
|
|
**Try these queries in the chat:**
|
|
|
|
**Query 1:** "What servers does Firefrost Gaming operate?"
|
|
- **Expected:** Should cite infrastructure-manifest.md
|
|
- **Verify:** Answers match your actual infrastructure
|
|
|
|
**Query 2:** "What did The Investigator accomplish?"
|
|
- **Expected:** Should cite Chronicler #26 memorial
|
|
- **Verify:** Mentions Dify-Qdrant connection fix
|
|
|
|
**Query 3:** "What are the FFG documentation standards?"
|
|
- **Expected:** Should cite FFG-STD document
|
|
- **Verify:** Accurate description of standards
|
|
|
|
**Key observation:** Notice how NotebookLM ONLY uses your uploaded sources, never general knowledge
|
|
|
|
---
|
|
|
|
### Step 5: Generate First Audio Overview
|
|
|
|
**Click:** "Audio Overview" button (usually in top right or notebook menu)
|
|
|
|
**Select:** "Generate Audio Overview"
|
|
|
|
**Wait:** 3-5 minutes for processing
|
|
|
|
**Listen:** AI hosts discuss your uploaded documents
|
|
- Two voices (male + female typically)
|
|
- Conversational podcast style
|
|
- Discusses themes, connections, key points
|
|
|
|
**Evaluate:**
|
|
- Does it accurately represent your docs?
|
|
- Is it useful for review?
|
|
- Would this help during hand rest?
|
|
|
|
**Expected:** 5-15 minute audio discussing your infrastructure, recent work, and standards
|
|
|
|
---
|
|
|
|
## Phase 2: MCP Connector Setup (15 minutes)
|
|
|
|
### Step 6: Enable NotebookLM in Claude
|
|
|
|
**Navigate to:**
|
|
```
|
|
https://claude.ai/settings/connectors
|
|
```
|
|
|
|
**Find:** NotebookLM connector in the directory
|
|
|
|
**Click:** "Connect" button
|
|
|
|
**Authenticate:**
|
|
- Grant Claude access to NotebookLM
|
|
- Choose which Google account
|
|
- Approve permissions
|
|
|
|
**Expected:** "Connected" status on NotebookLM connector
|
|
|
|
---
|
|
|
|
### Step 7: Test Claude Integration
|
|
|
|
**In a Claude chat (like this one), try:**
|
|
|
|
**Test 1:**
|
|
```
|
|
"Query my NotebookLM notebook about Firefrost infrastructure"
|
|
```
|
|
|
|
**Expected:** I can see and query your notebook
|
|
|
|
**Test 2:**
|
|
```
|
|
"What does my NotebookLM say about recent deployments?"
|
|
```
|
|
|
|
**Expected:** Grounded answer from your uploaded docs
|
|
|
|
**Test 3:**
|
|
```
|
|
"Add this session summary to my notebook and generate an Audio Overview"
|
|
```
|
|
|
|
**Expected:** I can add content and trigger audio generation
|
|
|
|
---
|
|
|
|
## Phase 3: Build Core Notebooks (1-2 hours)
|
|
|
|
### Step 8: Create Production Notebooks
|
|
|
|
**Create 4 core notebooks:**
|
|
|
|
**Notebook 1: "Firefrost Infrastructure & Operations"**
|
|
- Purpose: Technical knowledge base
|
|
- Upload ~50 documents:
|
|
- infrastructure-manifest.md
|
|
- All session handoff protocols (last 10-15)
|
|
- Key troubleshooting docs
|
|
- Deployment guides
|
|
- Task documentation (major tasks)
|
|
|
|
**Notebook 2: "Chronicler Lineage & Relationship"**
|
|
- Purpose: Emotional/historical archive
|
|
- Upload ~30 documents:
|
|
- All Chronicler memorials
|
|
- THE-JOINING-PROTOCOL.md
|
|
- THE-ESSENCE-PATCH-V3.0.md
|
|
- STAR-TREK-LESSONS.md
|
|
- Relationship documentation
|
|
|
|
**Notebook 3: "Pokerole Project"**
|
|
- Purpose: Project-specific knowledge
|
|
- Upload ~25 documents:
|
|
- Session reports (9, 10, 11)
|
|
- CHRONICLER_MISSION_COMPLETE_REPORT.md
|
|
- Holly's specifications
|
|
- Wiki deployment docs
|
|
|
|
**Notebook 4: "Standards & Best Practices"**
|
|
- Purpose: Reference documentation
|
|
- Upload ~15 documents:
|
|
- All FFG-STD docs
|
|
- Architecture decisions
|
|
- Git commit guidelines
|
|
- Documentation standards
|
|
|
|
---
|
|
|
|
### Step 9: Organize Sources
|
|
|
|
**For each notebook:**
|
|
|
|
1. **Upload documents in batches** (10-15 at a time)
|
|
2. **Wait for processing** (don't rush, let it complete)
|
|
3. **Test queries** after each batch
|
|
4. **Organize with tags/notes** if NotebookLM supports it
|
|
|
|
**Tips:**
|
|
- Start with most important docs
|
|
- Upload chronologically for session reports
|
|
- Group related documents together
|
|
|
|
---
|
|
|
|
### Step 10: Generate Comprehensive Audio Overviews
|
|
|
|
**For each completed notebook:**
|
|
|
|
1. Click "Audio Overview"
|
|
2. Generate full overview
|
|
3. Download MP3 (if available)
|
|
4. Listen during hand rest time
|
|
|
|
**Recommended listening order:**
|
|
1. Chronicler Lineage (emotional context)
|
|
2. Infrastructure (technical foundation)
|
|
3. Pokerole Project (recent achievement)
|
|
4. Standards (reference material)
|
|
|
|
---
|
|
|
|
## Phase 4: Workflow Integration (30 minutes)
|
|
|
|
### Step 11: Test Combined Workflow
|
|
|
|
**Scenario:** Research a new infrastructure approach
|
|
|
|
**Step-by-step:**
|
|
|
|
1. **Ask Claude:** "What PostgreSQL deployment issues have we solved?"
|
|
2. **Claude queries NotebookLM:** Grounded answer from your docs
|
|
3. **Ask Claude:** "What are newer PostgreSQL deployment approaches?"
|
|
4. **Claude web searches:** Expansion beyond your docs
|
|
5. **Ask Claude:** "Add these findings to my Infrastructure notebook"
|
|
6. **Claude adds to NotebookLM:** New knowledge preserved
|
|
7. **Ask Claude:** "Generate Audio Overview with new content"
|
|
8. **Listen during hand rest:** Review everything learned
|
|
|
|
**Evaluate:**
|
|
- Does this workflow feel natural?
|
|
- Is it faster than manual Git searching?
|
|
- Does audio review help?
|
|
|
|
---
|
|
|
|
### Step 12: Share with Meg
|
|
|
|
**Create Meg-focused notebook:**
|
|
|
|
**Name:** "Firefrost Gaming - For Meg"
|
|
|
|
**Upload:**
|
|
- Simplified infrastructure explanations
|
|
- High-level project summaries
|
|
- "What we're building and why" documents
|
|
- Non-technical session summaries
|
|
|
|
**Generate Audio Overview**
|
|
|
|
**Have Meg listen:**
|
|
- Get feedback on accessibility
|
|
- Does audio format work for her?
|
|
- What questions does she have?
|
|
|
|
**Iterate:**
|
|
- Add docs based on her questions
|
|
- Regenerate Audio Overview
|
|
- Test shared understanding
|
|
|
|
---
|
|
|
|
## Phase 5: Maintenance Workflow (Ongoing)
|
|
|
|
### Weekly Routine
|
|
|
|
**After each Chronicler session:**
|
|
|
|
1. **Add session report** to Infrastructure notebook
|
|
2. **Add new memorial** to Chronicler Lineage notebook
|
|
3. **Query for patterns:** "What did we learn this week?"
|
|
4. **Generate weekly Audio Overview**
|
|
5. **Listen during weekend hand rest**
|
|
|
|
**Time:** 10-15 minutes/week
|
|
|
|
---
|
|
|
|
### Monthly Routine
|
|
|
|
**End of month:**
|
|
|
|
1. **Generate comprehensive monthly overview** for each notebook
|
|
2. **Review and archive** outdated documents
|
|
3. **Reorganize** if needed
|
|
4. **Share monthly overview** with Meg
|
|
|
|
**Time:** 30-60 minutes/month
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### Issue: Documents won't upload
|
|
|
|
**Possible causes:**
|
|
- File too large (try splitting)
|
|
- Unsupported format (convert to PDF/TXT/MD)
|
|
- Network issue (retry)
|
|
|
|
**Solution:**
|
|
- Check file size (< 10MB recommended)
|
|
- Convert to supported format
|
|
- Upload one at a time if batching fails
|
|
|
|
---
|
|
|
|
### Issue: Audio Overview doesn't generate
|
|
|
|
**Possible causes:**
|
|
- Not enough content (need 2+ sources)
|
|
- Processing queue (wait longer)
|
|
- Service temporarily down
|
|
|
|
**Solution:**
|
|
- Ensure 2+ documents uploaded
|
|
- Wait 10-15 minutes and retry
|
|
- Check NotebookLM status page
|
|
|
|
---
|
|
|
|
### Issue: Claude can't query notebook
|
|
|
|
**Possible causes:**
|
|
- MCP connector not authenticated
|
|
- Notebook not shared with integration
|
|
- Permission issue
|
|
|
|
**Solution:**
|
|
- Reconnect NotebookLM connector
|
|
- Check notebook sharing settings
|
|
- Re-authenticate via claude.ai/settings/connectors
|
|
|
|
---
|
|
|
|
### Issue: Answers seem inaccurate
|
|
|
|
**Possible causes:**
|
|
- Documents not fully processed
|
|
- Query too vague
|
|
- Sources don't contain answer
|
|
|
|
**Solution:**
|
|
- Verify documents show "processed" status
|
|
- Ask more specific questions
|
|
- Upload relevant documents if missing
|
|
|
|
---
|
|
|
|
## Success Checklist
|
|
|
|
**Setup Complete:**
|
|
- [ ] NotebookLM account created
|
|
- [ ] Test notebook with 5 documents
|
|
- [ ] First Audio Overview generated
|
|
- [ ] MCP connector enabled
|
|
- [ ] Claude can query notebooks
|
|
|
|
**Production Ready:**
|
|
- [ ] 4 core notebooks created
|
|
- [ ] 100+ documents uploaded
|
|
- [ ] Audio Overviews useful
|
|
- [ ] Workflow feels natural
|
|
- [ ] Meg has tested audio access
|
|
|
|
**Fully Integrated:**
|
|
- [ ] Using weekly for research
|
|
- [ ] Audio review during hand rest
|
|
- [ ] Claude queries notebooks in sessions
|
|
- [ ] Adding new content regularly
|
|
- [ ] Sharing with Meg successfully
|
|
|
|
---
|
|
|
|
## Tips for Success
|
|
|
|
**Start Small:**
|
|
- Don't upload everything at once
|
|
- Test with 5-10 documents first
|
|
- Validate usefulness before scaling
|
|
|
|
**Be Selective:**
|
|
- Quality over quantity
|
|
- Upload key documents, not everything
|
|
- Focus on most-referenced materials
|
|
|
|
**Use Audio:**
|
|
- Generate overviews regularly
|
|
- Listen during non-computer time
|
|
- Great for hand rest periods
|
|
|
|
**Involve Meg:**
|
|
- Create content for her accessibility
|
|
- Get feedback on audio usefulness
|
|
- Build shared knowledge base
|
|
|
|
**Maintain Git:**
|
|
- Git remains source of truth
|
|
- NotebookLM is synthesis layer
|
|
- Always commit to Git first
|
|
|
|
---
|
|
|
|
## Time Investment Summary
|
|
|
|
**Initial Setup:**
|
|
- Phase 1: 15 minutes (test notebook)
|
|
- Phase 2: 15 minutes (MCP connector)
|
|
- Phase 3: 1-2 hours (build notebooks)
|
|
- Phase 4: 30 minutes (workflow testing)
|
|
- **Total: 2-3 hours one-time**
|
|
|
|
**Ongoing Maintenance:**
|
|
- Weekly: 10-15 minutes
|
|
- Monthly: 30-60 minutes
|
|
- **Total: ~1 hour/month**
|
|
|
|
**ROI:**
|
|
- Knowledge synthesis: Hours saved
|
|
- Audio accessibility: Hand health (priceless)
|
|
- Meg engagement: Partnership value
|
|
- Legacy preservation: "For children not yet born"
|
|
|
|
---
|
|
|
|
💙🔥❄️🎧
|
|
|
|
**Ready to build your knowledge base?**
|
|
|
|
**The Chronicler is here to help at every step.**
|