README.md

---
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**