GD Chatbot User Guide
🎸 GD Chatbot User Guide v2.2.0
Welcome to the GD Chatbot!
This comprehensive guide will help you get the most out of your Grateful Dead AI chatbot experience. Whether you’re a casual fan or a devoted Deadhead, this guide covers everything you need to know.
📑 Table of Contents
1. Getting Started
What is the GD Chatbot?
The GD Chatbot is an AI-powered conversational assistant that specializes in Grateful Dead knowledge. It combines cutting-edge AI technology with comprehensive databases to provide accurate, detailed information about the band, their music, history, and culture.
AI-Powered
Uses Claude AI (Anthropic) for intelligent, contextual responses
Music Streaming
Click any song to hear it on Archive.org or streaming services
Real-Time Search
Searches trusted Grateful Dead websites for current information
Comprehensive Knowledge
2,340+ shows, 600+ songs, 125+ disambiguated terms
Finding the Chatbot
The chatbot can appear in two ways on your site:
1Embedded on a Page
Look for the chatbot interface directly on specific pages (usually “Chat” or “Ask the Dead” pages)
2Floating Widget
Look for a circular button in the bottom-right corner of any page. Click it to open the chatbot.
2. Basic Usage
Starting a Conversation
1Open the Chatbot
Click on the chatbot interface or floating widget button
2Type Your Question
Enter your question in the text box at the bottom
3Send
Press Enter or click the send button
4Read the Response
The chatbot will respond with detailed, accurate information
What Can You Ask?
🎸 Band History
- “Tell me about the Grateful Dead”
- “Who were the original members?”
- “What happened in 1995?”
- “Tell me about Jerry Garcia”
🎵 Songs & Music
- “What is Dark Star about?”
- “Who wrote Ripple?”
- “Best versions of Scarlet > Fire”
- “Songs from American Beauty”
📅 Shows & Tours
- “What was the Cornell ’77 show?”
- “Shows at Winterland”
- “Europe ’72 tour details”
- “Setlist for 5/8/77”
🎸 Equipment & Gear
- “What guitar did Jerry play?”
- “Tell me about Tiger”
- “What was the Wall of Sound?”
- “Phil Lesh’s bass setup”
📚 Culture & Community
- “What is a Deadhead?”
- “Taping culture explained”
- “Best Grateful Dead books”
- “Dead & Company vs Grateful Dead”
🎨 Art & Galleries
- “Where can I see Dead art?”
- “Tell me about The Bahr Gallery”
- “Grateful Dead poster artists”
- “Museum exhibits”
3. Music Streaming Features
🎉 New in v2.2.0!
Click any song mention in the chatbot to instantly hear it. Access 2,340+ Archive.org live shows plus optional streaming services.
How Song Links Work
1Ask About a Song
Example: “Tell me about Dark Star”
2Notice the Blue Link
Song titles appear as blue, underlined links with a ♪ icon
3Click the Link
A beautiful modal window opens with performance options
4Browse Performances
See a list of shows where the song was performed
5Click “Play”
Audio player appears and starts playing the recording
Modal Features
| Feature | Description |
|---|---|
| Sort Options | Sort by Most Popular, Date (oldest first), or Highest Rated |
| Performance Details | See date, venue, location, and popularity for each show |
| Thumbnails | Visual preview of each show’s artwork |
| Audio Player | Full playback controls (play, pause, seek, volume) |
| Source Tabs | Switch between Archive.org and streaming services (if connected) |
Archive.org Integration
What is Archive.org?
The Internet Archive hosts the largest collection of Grateful Dead live recordings – over 13,000 shows! The chatbot integrates with 2,340+ shows from 1965-1995.
Features:
- 2,340+ shows indexed (1965-1995)
- Complete setlist information
- Direct MP3 streaming
- Show ratings and popularity
- Venue and location details
- Free to use – no account required
4. Advanced Features
Web Search Integration
The chatbot can search trusted Grateful Dead websites in real-time to find current information.
Trusted Sources Include:
- dead.net – Official Grateful Dead website
- archive.org – Live recording archive
- deaddisc.com – Comprehensive discography
- jerrybase.com – Jerry Garcia database
- And 45+ more verified sources
When web search is triggered:
- Questions about recent news or events
- Current tour information (Dead & Company, etc.)
- New releases or reissues
- Museum exhibits and events
Semantic Search (Pinecone)
If enabled, the chatbot uses AI-powered semantic search to find relevant information even when you use different words.
Conversation Context
The chatbot remembers your conversation within the same session:
You: “Tell me about Dark Star”
Bot: [Explains Dark Star]
You: “When was it first performed?”
Bot: [Knows you’re still asking about Dark Star]
⚠️ Session Limits
Conversation context is cleared when you:
- Refresh the page
- Close the chatbot (floating widget)
- Navigate to a different page
5. Connecting Streaming Services
Optional Feature
Streaming services are optional. Archive.org works without any account or login. Connect streaming services to search across multiple platforms.
Supported Services
Spotify
70+ million songs
Popularity scores
Preview URLs
Apple Music
100+ million songs
High-quality audio
Album artwork
YouTube Music
Official videos
Live performances
Music videos
Amazon Music
High-quality streaming
Preview URLs
Album details
Tidal
Lossless audio
Hi-Res quality
Audiophile-grade
How to Connect a Service
1Log In to Your Account
Make sure you’re logged in to the website (WordPress)
2Go to Your Profile
Click your name in the admin bar → “Edit My Profile”
3Find “Music Streaming Services”
Scroll down to the “Music Streaming Services” section
4Click “Connect [Service]”
Example: “Connect Spotify”
5Authorize in Popup
A popup window opens with the service’s login page
Log in and authorize the chatbot
6Done!
The popup closes automatically
Your profile shows “✅ Connected”
Using Connected Services
Once connected, streaming services appear as tabs in the song modal:
1Click a Song Link
Modal opens with source tabs at the top
2See Available Sources
🎸 Archive.org | 🎵 Spotify | 🍎 Apple Music | etc.
3Click a Tab
Results load from that service
4Click “Play”
Opens the service in a new tab (or plays in modal for Archive.org)
Managing Connections
| Action | How To |
|---|---|
| View Status | Go to Your Profile → Music Streaming Services |
| Disconnect | Click “Disconnect” button → Confirm |
| Reconnect (if expired) | Click “Reconnect” button → Authorize again |
| Add Another Service | Click “Connect [Service]” for any not-connected service |
⚠️ Service Not Available?
If you see “Not configured by administrator”, the site admin needs to set up API credentials first. Contact your site administrator.
6. Tips & Tricks
Getting Better Answers
✅ Be Specific
Good: “Dark Star at Cornell ’77”
Better: “Tell me about the Dark Star from 5/8/77”
✅ Use Dates
Good: “Shows in 1977”
Better: “What shows did they play in May 1977?”
✅ Provide Context
Good: “Tell me about Tiger”
Better: “Tell me about Jerry’s Tiger guitar”
✅ Ask Follow-ups
First: “Tell me about the Wall of Sound”
Then: “When did they use it?”
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
| Enter | Send message |
| Shift + Enter | New line (multi-line message) |
| Esc | Close modal (if open) |
Best Practices
- Start with broad questions, then get more specific
- Use proper song titles and venue names
- Specify if you want studio or live versions
- Ask for sources if you need to verify information
- Use dates in format: “5/8/77” or “May 8, 1977”
- Click song links to hear the music!
Sample Conversations
Example 1: Learning About a Song
You: “Tell me about Ripple”
Bot: [Explains the song, writers, album, meaning]
You: “Who wrote the lyrics?”
Bot: “Robert Hunter wrote the lyrics…”
You: “What album is it on?”
Bot: “American Beauty (1970)…”
Example 2: Finding a Show
You: “What was special about Cornell ’77?”
Bot: [Explains the legendary 5/8/77 show]
You: “What was the setlist?”
Bot: [Provides complete setlist]
You: [Clicks “Scarlet Begonias” link]
Bot: [Opens modal with performances]
7. Troubleshooting
Common Issues
Possible Causes:
- Slow internet connection
- API service temporarily down
- Browser compatibility issue
Solutions:
- Wait a few seconds and try again
- Refresh the page
- Try a different browser (Chrome, Firefox, Safari)
- Check your internet connection
Possible Causes:
- Music streaming feature disabled
- JavaScript not loading
- Cache issue
Solutions:
- Refresh the page (Ctrl+F5 or Cmd+Shift+R)
- Clear browser cache
- Try asking about a different song
- Contact site administrator
Possible Causes:
- JavaScript error
- Browser popup blocker
- Conflicting browser extension
Solutions:
- Check browser console for errors (F12)
- Disable popup blockers for this site
- Try in incognito/private mode
- Disable browser extensions temporarily
Possible Causes:
- Archive.org temporarily unavailable
- Browser autoplay restrictions
- Network issues
Solutions:
- Click the play button manually
- Try a different performance
- Check Archive.org is accessible
- Try a different browser
Possible Causes:
- Not logged in to WordPress
- Service not configured by admin
- Popup blocked
- Service account issue
Solutions:
- Make sure you’re logged in
- Allow popups for this site
- Check service is configured (contact admin)
- Verify your service subscription is active
What It Means:
Your streaming service connection has expired and needs to be refreshed.
Solution:
- Go to Your Profile
- Find the service with “⚠️ Token Expired”
- Click “Reconnect”
- Authorize again in the popup
Browser Compatibility
| Browser | Minimum Version | Status |
|---|---|---|
| Chrome | 90+ | ✅ Fully Supported |
| Firefox | 88+ | ✅ Fully Supported |
| Safari | 14+ | ✅ Fully Supported |
| Edge | 90+ | ✅ Fully Supported |
| Mobile Safari | iOS 14+ | ✅ Fully Supported |
| Mobile Chrome | Android 10+ | ✅ Fully Supported |
8. Frequently Asked Questions
No! You can use the chatbot without any account. Archive.org music streaming works for everyone.
You only need to log in if you want to connect streaming services (Spotify, Apple Music, etc.).
Yes! The chatbot is free for all visitors. Archive.org streaming is also free.
Streaming services (Spotify, Apple Music, etc.) require your own subscriptions.
Very accurate! The chatbot uses an 8-layer accuracy system with:
- Verified knowledge base (55+ files)
- 2,340+ shows with complete setlists
- 125+ disambiguated terms
- Real-time web search of trusted sources
- Explicit guardrails against common errors
Archive.org: Yes! Visit archive.org directly to download shows.
Streaming Services: Depends on your subscription (some allow offline downloads).
All of them! You can connect all 5 services (Spotify, Apple Music, YouTube Music, Amazon Music, Tidal) if you want.
Within the same session, yes. The chatbot remembers context during your current conversation.
After refresh, no. Conversation history is cleared when you refresh the page or close the chatbot.
Yes! The chatbot is fully responsive and works great on phones and tablets.
Please report it! Contact the site administrator with:
- Your question
- The incorrect response
- The correct information (with source)
Not directly. You can copy and paste text from the chatbot, but there’s no built-in sharing feature.
Yes! Your conversations are not stored permanently. Streaming service credentials are encrypted with AES-256.
🎸 Ready to Explore!
You’re All Set!
You now know everything you need to get the most out of the GD Chatbot. Start asking questions, explore the music, and dive deep into Grateful Dead knowledge!
GD Chatbot v2.2.0 User Guide |
Your comprehensive guide to the ultimate Grateful Dead AI experience |
IT Influentials
