Skip to content

kaiser-data/explainor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

54 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

title Explainor
emoji 🎭
colorFrom purple
colorTo pink
sdk gradio
sdk_version 6.0.1
app_file app.py
pinned false
license mit
short_description AI agent explains topics in fun character voices with MCP
tags
mcp-in-action-track-creative

🎭 Explainor

Learn anything through the voice of your favorite characters!

MCP Hackathon Track Category


🌟 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

🔌 MCP Server Integration

This app is a real MCP Server! You can connect it to Claude Desktop or any MCP-compatible client.

MCP Endpoint:

https://agents-mcp-hackathon-explainor.hf.space/gradio_api/mcp/sse

Available Tools:

  • explain_topic - Get explanations in character voices
  • generate_audio - Generate TTS audio from explanations

🚀 Tech Stack

  • MCP: Model Context Protocol - App exposes itself as an MCP server via Gradio
  • LLM: Nebius AI - Llama 3.3 70B for intelligent explanations
  • TTS: ElevenLabs - Realistic voice synthesis with character-matched voices
  • Web Search: DuckDuckGo API for topic research
  • Frontend: Gradio with native MCP integration

🏆 Hackathon Submission

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

📹 Demo Video

Watch Demo on Vimeo

📱 Social Post

LinkedIn Post

📝 License

MIT License - Feel free to use and modify!


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

About

AI Agent that explains any topic in fun persona voices - MCP 1st Birthday Hackathon

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors