Hugging Face's logo

Spaces:
Agents-MCP-Hackathon
/
explainor
Sleeping

App Files Community
explainor
File size: 2,728 Bytes 
0728164
 
 
 
e4e2092
0728164
 
 
 
 
 
 
 
 
074e8ce
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
196685d
 
074e8ce
196685d
 
074e8ce
 
196685d
 
 
 
 
 
 
 
 
 
 
074e8ce
 
 
 
 
196685d
074e8ce
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
 
---
title: Explainor
emoji: 🎭
colorFrom: purple
colorTo: pink
sdk: gradio
sdk_version: 5.0.0
app_file: app.py
pinned: false
license: mit
tags:
  - mcp-in-action-track-creative
---

# 🎭 Explainor

> **Learn anything through the voice of your favorite characters!**

[![MCP Hackathon](https://img.shields.io/badge/MCP%20Hackathon-1st%20Birthday-purple)](https://huggingface.co/MCP-1st-Birthday)
[![Track](https://img.shields.io/badge/Track-MCP%20in%20Action-blue)](https://huggingface.co/MCP-1st-Birthday)
[![Category](https://img.shields.io/badge/Category-Creative-green)](https://huggingface.co/MCP-1st-Birthday)

---

## 🌟 What is Explainor?

Explainor is an AI agent that takes any topic you want to learn about and explains it through the voice of fun characters! Choose from 6 unique personas:

| Persona | Style |
|---------|-------|
| 👶 **5-Year-Old** | Simple words, excited, curious questions |
| 👨‍🍳 **Gordon Ramsay** | Intense, food metaphors, "It's RAW!" |
| 🏴‍☠️ **Pirate** | "Arrr!", treasure metaphors, swashbuckling |
| 🎭 **Shakespeare** | Dramatic, old English, theatrical |
| 🏄 **Surfer Dude** | "Brooo", chill vibes, wave metaphors |
| 🧙 **Yoda** | Inverted syntax, wise, Force references |

## 🛠️ How It Works

1. **Enter a topic** - Anything from "Quantum Computing" to "How do volcanoes work?"
2. **Choose a persona** - Pick your favorite character
3. **Choose your audience** - Who are you explaining to?
4. **Watch the magic** - The AI agent:
   - 🔍 Researches your topic using web search
   - 📋 Extracts key facts from sources
   - 🎭 Transforms the explanation into the character's voice
   - 🔊 Reads it aloud with a matching voice!

## 👤 Who's Listening?

Make the explanation even more tailored by choosing your audience:

| Audience | Effect |
|----------|--------|
| 👤 Just me | Standard explanation |
| 👵 My confused grandmother | Extra simple, patient |
| 🤖 A skeptical robot | Logical, evidence-based |
| 👽 An alien visiting Earth | Explain Earth concepts |

## 🚀 Tech Stack

- **LLM**: [Nebius AI](https://nebius.com) - Llama 3.3 70B for intelligent explanations
- **TTS**: [ElevenLabs](https://elevenlabs.io) - Realistic voice synthesis with character-matched voices
- **Web Search**: DuckDuckGo API for topic research
- **Frontend**: [Gradio](https://gradio.app) with MCP integration

## 🏆 Hackathon Submission

- **Event**: MCP's 1st Birthday Hackathon
- **Track**: MCP in Action (Track 2)
- **Category**: Creative
- **Team**: kaiser-data
- **Sponsor Integration**: ElevenLabs for text-to-speech

## 📝 License

MIT License - Feel free to use and modify!

---

**Made with ❤️ for MCP's 1st Birthday Hackathon**