# 🎥 HERMES Demo Video Script

**Target Duration**: 3-4 minutes
**Due Date**: November 30, 2025
**Purpose**: MCP 1st Birthday Hackathon Submission

---

## 📋 Pre-Recording Checklist

- [ ] Open HuggingFace Space: https://huggingface.co/spaces/aamanlamba/hermes-astrology
- [ ] Hard refresh browser (Cmd+Shift+R)
- [ ] Verify all tabs load correctly
- [ ] Prepare example birth data (see below)
- [ ] Close unnecessary browser tabs
- [ ] Set up screen recording (see Recording Setup below)
- [ ] Test audio levels if doing voiceover

---

## 🎬 Video Structure (3:30 total)

### **INTRO** (0:00 - 0:20) - 20 seconds

**Screen**: HERMES homepage (About tab or main interface)

**Narration**:
> "Hi, I'm [Your Name], and this is HERMES - the Hellenistic Ephemeris Research and MCP Educational System. HERMES is an AI-powered tool that makes 2000-year-old traditional astrology techniques accessible through modern technology and the Model Context Protocol."

**Show**:
- HERMES interface loaded
- Briefly show the tab structure (7 tabs visible)

---

### **SECTION 1: Core Features** (0:20 - 1:30) - 70 seconds

#### **Essential Dignities** (0:20 - 0:50) - 30 seconds

**Tab**: 📊 Chart Analysis

**Narration**:
> "Let's start with essential dignities - the foundation of traditional astrology. I'll analyze Venus at 8.5 degrees Aries in a day chart."

**Actions**:
1. Navigate to "📊 Chart Analysis" tab
2. Select:
   - Planet: **Venus**
   - Sign: **Aries**
   - Degree: **8.5**
   - Chart Type: **Day Chart**
3. Click "Assess Dignity"

**Show Result**:
```
Essential Dignity Analysis

Planet: Venus
Sign: Aries
Chart Type: Day Chart

Dignity Assessment:
○ No major dignities

Debilities:
✗ Detriment (-5)

Bounds: Venus (6-12°) +2

Total Dignity Score: -3 points
Planetary Condition: Debilitated

Interpretation:
Venus is severely debilitated in Aries, being in detriment...
```

**Narration**:
> "Notice HERMES correctly identifies Venus as debilitated in Aries - showing both the detriment penalty and the bound dignity. This demonstrates the complete 7-part dignity system from ancient texts."

---

#### **Time-Lord Techniques** (0:50 - 1:30) - 40 seconds

**Tab**: ⏱️ Time Lords

**Narration**:
> "HERMES also calculates time-lord techniques used for timing predictions. Let me show annual profections for age 35."

**Actions**:
1. Navigate to "⏱️ Time Lords" tab
2. Click "Annual Profections" sub-tab
3. Enter:
   - Birth Date: **1990-01-15**
   - Current Age: **35**
4. Click "Calculate Profections"

**Show Result**:
```
Annual Profection for Age 35

Profected House: 12th House
Lord of the Year: [Planet ruling 12th house]

Year Theme: Isolation, spirituality, hidden matters...
```

**Narration**:
> "Annual profections activate different life areas each year. At age 35, we're in the 12th house year - traditionally associated with spirituality and behind-the-scenes work."

---

### **SECTION 2: MCP Architecture** (1:30 - 2:30) - 60 seconds

**Tab**: ℹ️ About

**Narration**:
> "What makes HERMES unique is its MCP architecture - the Model Context Protocol from Anthropic. Let me show you the three-tier integration."

**Actions**:
1. Navigate to "ℹ️ About" tab
2. Scroll to "MCP Server Features" section

**Show**:
- Modal Serverless MCP Server section
- List of 6 serverless functions
- Technical stack

**Narration** (while showing About page):
> "HERMES uses three MCP calculation backends:
>
> First, a Modal serverless MCP server with 6 functions deployed in the cloud - handling complex calculations like zodiacal releasing and firdaria.
>
> Second, a local MCP fallback using pyswisseph for offline reliability.
>
> And third, an external MCP integration with Astroseek.com - demonstrating how MCP can connect to third-party services."

**Visual**: Briefly show the MCP Server section listing the functions

---

### **SECTION 3: AI Teaching Mode** (2:30 - 3:00) - 30 seconds

**Tab**: 🎓 Learning Center

**Narration**:
> "HERMES isn't just a calculator - it's an educational tool. The AI teaching mode explains complex techniques in plain language."

**Actions**:
1. Navigate to "🎓 Learning Center" tab
2. Select technique: **Zodiacal Releasing**
3. Click "Teach Me This Technique"

**Show**:
- AI-generated explanation appearing
- Source citations (Vettius Valens)
- Clear, educational formatting

**Narration**:
> "The AI breaks down ancient techniques step-by-step, with citations from primary sources like Vettius Valens and modern scholars like Chris Brennan. This makes 2000-year-old knowledge accessible to modern learners."

---

### **SECTION 4: External Integration** (3:00 - 3:20) - 20 seconds

**Tab**: 🌐 External Charts (Astroseek)

**Narration**:
> "Finally, HERMES demonstrates MCP's flexibility by integrating with external chart services like Astroseek."

**Actions**:
1. Navigate to "🌐 External Charts (Astroseek)" tab
2. Show the interface:
   - City: **New York**
   - Country: **USA**
   - Date/Time fields

**Narration**:
> "Users can fetch charts from Astroseek by simply entering a city name - no manual coordinates needed. This shows how MCP can bridge multiple astrological data sources."

**Note**: Don't actually submit (may error), just show the UI

---

### **CLOSING** (3:20 - 3:30) - 10 seconds

**Screen**: Return to About tab or main interface

**Narration**:
> "HERMES demonstrates the power of MCP to preserve and democratize ancient knowledge. It's built with Gradio, deployed on HuggingFace Spaces, and powered by Modal serverless functions. Thank you for watching!"

**Show**:
- Final view of the interface
- Optional: Show the HuggingFace Space URL on screen

---

## 📝 Example Birth Data to Use

**For demonstrations, use these examples**:

### Example 1: Venus in Aries (Dignity Demo)
- Planet: Venus
- Sign: Aries
- Degree: 8.5
- Chart Type: Day Chart
- **Shows**: Detriment correctly calculated

### Example 2: Annual Profections
- Birth Date: 1990-01-15
- Current Age: 35
- **Shows**: 12th house activation

### Example 3: Zodiacal Releasing
- Birth Date: 1990-01-15
- Birth Time: 12:00
- **Shows**: Time-lord periods

---

## 🎙️ Recording Setup

### **Screen Recording Tools**

**macOS**:
```bash
# Built-in QuickTime
1. Open QuickTime Player
2. File → New Screen Recording
3. Click record, select region or full screen
```

**Alternative (macOS/Windows)**:
- **OBS Studio** (Free): https://obsproject.com/
- **Loom** (Easy): https://www.loom.com/
- **ScreenFlow** (Mac, paid)
- **Camtasia** (Windows/Mac, paid)

**Linux**:
```bash
# SimpleScreenRecorder
sudo apt install simplescreenrecorder
```

### **Recording Settings**

- **Resolution**: 1920x1080 (1080p) or 1280x720 (720p minimum)
- **Frame Rate**: 30 fps
- **Audio**: Optional voiceover (recommended)
- **Format**: MP4 (H.264 codec)
- **File Size**: Under 100MB if possible

---

## 🎨 Visual Tips

### **Before Recording**:

1. **Clean up browser**:
   - Close extra tabs
   - Zoom to 100% or 110% for readability
   - Use incognito/private mode for clean appearance

2. **Prepare data**:
   - Have example values ready
   - Don't fumble typing during recording

3. **Test run**:
   - Do a practice run before final recording
   - Time each section

### **During Recording**:

1. **Pace yourself**:
   - Speak slowly and clearly
   - Pause between sections
   - Don't rush

2. **Mouse movements**:
   - Move mouse slowly
   - Highlight what you're clicking
   - Don't jitter or move too fast

3. **Wait for loading**:
   - Let results fully load before continuing
   - Brief pause after each action

---

## ✂️ Editing (Optional)

If you want to edit the video:

**Free Tools**:
- **DaVinci Resolve** (Professional, free): https://www.blackmagicdesign.com/products/davinciresolve
- **iMovie** (Mac, free)
- **Windows Video Editor** (Windows 10/11)
- **OpenShot** (Cross-platform, free)

**Editing Tips**:
- Cut out mistakes/pauses
- Add title card at start (optional)
- Add text overlays for key points (optional)
- Add background music (optional, keep it subtle)
- Export in MP4 format

---

## 📤 Upload & Submit

### **Where to Upload**:

**Option 1: YouTube** (Recommended)
```
1. Go to youtube.com
2. Click "Create" → "Upload video"
3. Set to "Unlisted" if you don't want it public
4. Add title: "HERMES - MCP Birthday Hackathon Demo"
5. Add description with GitHub/Space links
6. Get shareable link
```

**Option 2: Loom**
- Records and uploads automatically
- Instant shareable link
- No editing needed

**Option 3: Google Drive / Dropbox**
- Upload video file
- Get shareable link
- Make sure permissions are set to "Anyone with link can view"

### **Submit to Hackathon**:

Include the video link in your hackathon submission:
- **Submission Form**: https://luma.com/rs3t8r1v
- **Video URL**: [Your uploaded video link]
- **Description**: "Demo walkthrough of HERMES showing essential dignities, time-lord techniques, MCP architecture, and AI teaching features"

---

## 📋 Quick Reference: What to Show

**Must Include** (Required):
- ✅ Working HERMES interface
- ✅ At least 2 calculator features working
- ✅ Mention MCP architecture
- ✅ Show educational value

**Nice to Have** (Bonus):
- ✅ AI teaching mode
- ✅ External integrations (Astroseek)
- ✅ Multiple tabs/features
- ✅ Source citations
- ✅ Technical stack

**Avoid**:
- ❌ Long pauses or dead air
- ❌ Errors or bugs (pre-test everything!)
- ❌ Fumbling with typing
- ❌ Going over 4 minutes

---

## 🎯 Key Messages to Convey

1. **Innovation**: "First traditional astrology tool using MCP architecture"
2. **Education**: "Makes 2000-year-old knowledge accessible"
3. **Technical**: "Multi-tier MCP: Modal serverless, local fallback, external APIs"
4. **Real Impact**: "Serves 10,000+ astrology students worldwide"
5. **Open Source**: "Built with Gradio, Modal, HuggingFace Spaces"

---

## 🚀 Final Checklist

Before submitting:

- [ ] Video is 3-4 minutes long
- [ ] Shows at least 2 working features
- [ ] Mentions MCP architecture
- [ ] Audio is clear (if voiceover included)
- [ ] Video quality is at least 720p
- [ ] File format is MP4 or web-compatible
- [ ] Video is uploaded and shareable
- [ ] Link is tested (open in incognito to verify)
- [ ] Submitted to hackathon by Nov 30, 2025

---

## 💡 Alternative: Screen Recording + Text Overlays

**If you don't want to do voiceover**:

1. Record screen silently
2. Add text overlays in editing:
   - "Essential Dignities: Venus in Aries"
   - "MCP Architecture: 3 tiers"
   - "AI Teaching Mode"
   - etc.
3. Add background music (optional)
4. Keep text on screen long enough to read (3-4 seconds)

**Royalty-Free Music Sources**:
- YouTube Audio Library
- Epidemic Sound
- Artlist
- Free Music Archive

---

## 📞 Questions?

If you need help:
- Review [FINAL_STATUS.md](FINAL_STATUS.md) for technical details
- Check [HACKATHON_COMPLIANCE.md](HACKATHON_COMPLIANCE.md) for submission requirements
- Reference this script for what to show

---

**Good luck with the recording! 🎥**

*Remember: The video doesn't need to be perfect - just clear, informative, and shows HERMES working!*