|
|
--- |
|
|
title: Course Creator AI - Multi-Tool Agent Demo |
|
|
emoji: 🎓 |
|
|
colorFrom: blue |
|
|
colorTo: purple |
|
|
sdk: gradio |
|
|
sdk_version: 5.33.1 |
|
|
app_file: app.py |
|
|
pinned: false |
|
|
license: mit |
|
|
tags: |
|
|
- agent-demo-track |
|
|
- education |
|
|
- ai-agents |
|
|
- course-generation |
|
|
- multi-tool |
|
|
- web-research |
|
|
- image-generation |
|
|
- gradio |
|
|
- hackathon |
|
|
short_description: AI-powered educational course generator |
|
|
--- |
|
|
|
|
|
# 🎓 Course Creator AI - Multi-Tool Agent Demo |
|
|
|
|
|
**Track 3: Agentic Demo Submission** | **Hugging Face Agent Hackathon 2025** |
|
|
|
|
|
> **🎯 Tag**: `agent-demo-track` |
|
|
|
|
|
## 🎬 Video Overview |
|
|
|
|
|
**📹 [Watch Demo Video - App Usage & Purpose Explanation](https://youtu.be/3VS010g4_c8)** |
|
|
|
|
|
|
|
|
--- |
|
|
|
|
|
## 🚀 What is Course Creator AI? |
|
|
|
|
|
Course Creator AI is a **real multi-tool agent system** that demonstrates the power of AI agents working together to create comprehensive educational content. This isn't a simulation - it's a live demonstration of agents using actual tools and APIs to research, generate, and create educational materials. |
|
|
|
|
|
### 🎯 **Purpose & Vision** |
|
|
|
|
|
Transform any topic into a complete, engaging educational experience through intelligent agent orchestration. Perfect for educators, students, content creators, and anyone looking to learn or teach effectively. |
|
|
|
|
|
## 🤖 **Real Agent Workflow in Action** |
|
|
|
|
|
Watch our agents work together in real-time: |
|
|
|
|
|
### **🔍 Research Agent** |
|
|
- **Tool**: DuckDuckGo Search API |
|
|
- **Action**: Searches the web for current, relevant information |
|
|
- **Output**: Curated research data and reliable sources |
|
|
|
|
|
### **📝 Content Agent** |
|
|
- **Tool**: Advanced LLM Integration (OpenAI, Anthropic, Google Gemini) |
|
|
- **Action**: Processes research into structured educational content |
|
|
- **Output**: Comprehensive lessons with learning objectives, interactive flashcards, and quiz |
|
|
|
|
|
### **🎨 Image Agent** |
|
|
- **Tool**: Pollinations API (GPT-Image Model) |
|
|
- **Action**: Generates contextual educational images |
|
|
- **Output**: High-quality, relevant visual aids |
|
|
|
|
|
### **🧠 Assessment Agent** |
|
|
- **Tool**: Intelligent Content Analysis |
|
|
- **Action**: Creates interactive learning materials |
|
|
- **Output**: Flashcards and quizzes for knowledge retention |
|
|
|
|
|
## ✨ **Key Features** |
|
|
|
|
|
### 🎓 **Complete Course Generation** |
|
|
- **5 Comprehensive Lessons** with detailed content (2000+ words each) |
|
|
- **Learning Objectives** tailored to difficulty level |
|
|
- **Real-world Examples** and practical applications |
|
|
- **Progressive Difficulty** building from fundamentals |
|
|
|
|
|
### 🃏 **Interactive Learning Materials** |
|
|
- **15 Smart Flashcards** for key concept reinforcement |
|
|
- **10 Multiple-Choice Questions** with detailed explanations |
|
|
- **Immediate Feedback** and scoring system |
|
|
- **Category-based Organization** for focused study |
|
|
|
|
|
### 🖼️ **Visual Learning Enhancement** |
|
|
- **AI-Generated Educational Images** using Flux model |
|
|
- **Contextual Visual Aids** that enhance understanding |
|
|
- **No Watermarks** - clean, professional imagery |
|
|
- **Smart Placeholder System** for optimal image placement |
|
|
|
|
|
### 🔧 **Multi-Provider LLM Support** |
|
|
- **OpenAI GPT Models** for premium quality |
|
|
- **Anthropic Claude** for detailed analysis |
|
|
- **Google Gemini** for cost-effective generation |
|
|
- **OpenAI-Compatible APIs** for flexibility |
|
|
- **Smart Provider Switching** via environment variables |
|
|
|
|
|
## 🛠️ **Technical Architecture** |
|
|
|
|
|
### **Agent Orchestration** |
|
|
``` |
|
|
Research Agent → Content Agent → Assessment Agent → Image Agent |
|
|
↓ ↓ ↓ ↓ |
|
|
Web Search → Lesson Creation → Quiz Generation → Visual Enhancement |
|
|
``` |
|
|
|
|
|
### **Real Tool Integration** |
|
|
- **🌐 Web Research**: Live DuckDuckGo search with Crawl4AI content extraction |
|
|
- **🧠 LLM Processing**: Multi-provider support with smart JSON parsing |
|
|
- **🎨 Image Generation**: Pollinations API with Flux model |
|
|
- **📊 Content Analysis**: Intelligent educational content structuring |
|
|
|
|
|
### **Smart Features** |
|
|
- **Markdown-Aware JSON Parser** handles LLM response variations |
|
|
- **Provider Fallback System** ensures reliability |
|
|
- **Real-time Progress Tracking** (console-based) |
|
|
- **Error Recovery** with graceful degradation |
|
|
|
|
|
## 🎮 **How to Use** |
|
|
|
|
|
### **1. Quick Start** |
|
|
1. **Enter Your Topic**: Anything from "Python Programming" to "Ancient History" |
|
|
2. **Choose Difficulty**: Beginner, Intermediate, or Advanced |
|
|
3. **Set Lesson Count**: 3-7 lessons based on your needs |
|
|
4. **Click Generate**: Watch the agents work their magic! |
|
|
|
|
|
### **2. Explore Your Course** |
|
|
- **📚 Course Overview**: See the complete structure and learning objectives |
|
|
- **📖 Lessons**: Dive into detailed, research-backed content |
|
|
- **🃏 Flashcards**: Test your knowledge with interactive cards |
|
|
- **📝 Quiz**: Challenge yourself with comprehensive questions |
|
|
- **🎨 Images**: Enjoy AI-generated visual learning aids |
|
|
|
|
|
### **3. Interactive Learning** |
|
|
- **Flip Flashcards** to reveal answers |
|
|
- **Take the Quiz** with immediate feedback |
|
|
- **Review Explanations** for deeper understanding |
|
|
- **Track Your Progress** through the material |
|
|
|
|
|
## 🔧 **Configuration** |
|
|
|
|
|
### **🚀 Quick Start (Hugging Face Space)** |
|
|
1. **Select LLM Provider**: Choose from OpenAI, Anthropic, Google Gemini, or OpenAI-Compatible |
|
|
2. **Enter API Key**: Add your API key in the interface |
|
|
3. **Generate Course**: Enter any topic and start creating! |
|
|
|
|
|
### **Provider Options** |
|
|
- **🆓 Google Gemini**: Free tier available, excellent quality |
|
|
- **💎 OpenAI GPT**: Premium quality, requires paid API |
|
|
- **🧠 Anthropic Claude**: Advanced reasoning, requires paid API |
|
|
- **🔗 OpenAI-Compatible**: Use any compatible endpoint |
|
|
|
|
|
### **🎨 Image Generation** |
|
|
- **Automatic**: High-quality educational images generated automatically |
|
|
- **No Setup Required**: Image generation credentials are pre-configured |
|
|
- **Professional Quality**: Clean, watermark-free educational visuals |
|
|
|
|
|
## 🏆 **Why This Demonstrates Real Agent Power** |
|
|
|
|
|
### **🔄 Multi-Tool Orchestration** |
|
|
Unlike simple chatbots, our agents actually use real tools: |
|
|
- **Web APIs** for current information |
|
|
- **Image Generation APIs** for visual content |
|
|
- **Multiple LLM providers** for diverse capabilities |
|
|
- **Content Processing Tools** for structured output |
|
|
|
|
|
### **🎯 Practical Real-World Application** |
|
|
- **Educators** can generate curriculum quickly |
|
|
- **Students** can create study materials for any topic |
|
|
- **Content Creators** can produce educational resources |
|
|
- **Businesses** can develop training materials |
|
|
|
|
|
### **🚀 Scalable Architecture** |
|
|
- **Modular Design** allows easy tool addition |
|
|
- **Provider Agnostic** works with any LLM service |
|
|
- **Error Resilient** handles API failures gracefully |
|
|
- **Performance Optimized** for real-world usage |
|
|
|
|
|
## 📊 **Demo Statistics** |
|
|
|
|
|
- **🎓 Courses Generated**: Unlimited topics supported |
|
|
- **📖 Content Volume**: 10,000+ words per complete course |
|
|
- **🎨 Images Created**: Up to 15 educational visuals per course |
|
|
- **🧠 Assessment Items**: 25+ interactive learning elements per course |
|
|
- **⚡ Generation Time**: 2-5 minutes for complete course |
|
|
- **🌍 Language Support**: Multi-language content generation |
|
|
|
|
|
## 🛡️ **Reliability Features** |
|
|
|
|
|
### **Smart Error Handling** |
|
|
- **Provider Fallback**: Automatically switches if primary LLM fails |
|
|
- **JSON Recovery**: Handles malformed responses gracefully |
|
|
- **Content Validation**: Ensures educational quality standards |
|
|
- **API Resilience**: Continues operation despite individual tool failures |
|
|
|
|
|
### **Quality Assurance** |
|
|
- **Research Verification**: Cross-references multiple sources |
|
|
- **Content Coherence**: Maintains logical lesson progression |
|
|
- **Assessment Alignment**: Quizzes match lesson objectives |
|
|
- **Visual Relevance**: Images enhance specific content points |
|
|
|
|
|
## 🎯 **Perfect for Hackathon Judging** |
|
|
|
|
|
### **✅ Innovation** |
|
|
- Real multi-tool agent orchestration (not simulated) |
|
|
- Novel educational content generation approach |
|
|
- Creative use of multiple AI services together |
|
|
|
|
|
### **✅ Technical Excellence** |
|
|
- Robust error handling and provider fallbacks |
|
|
- Clean, modular architecture |
|
|
- Real-time tool integration |
|
|
- Professional UI/UX design |
|
|
|
|
|
### **✅ Practical Impact** |
|
|
- Immediate value for educators and learners |
|
|
- Scalable to any educational domain |
|
|
- Production-ready implementation |
|
|
- Clear business applications |
|
|
|
|
|
### **✅ User Experience** |
|
|
- Intuitive interface requiring no technical knowledge |
|
|
- Engaging interactive elements |
|
|
- Professional visual design |
|
|
- Comprehensive feature set |
|
|
|
|
|
## 🚀 **Try It Now!** |
|
|
|
|
|
Experience the power of real AI agents working together to create educational content. Generate a course on any topic and watch as our agents research, create, and enhance your learning experience in real-time! |
|
|
|
|
|
**🎓 [Launch Course Creator AI](https://huggingface.co/spaces/Agents-MCP-Hackathon/course-creator-ai)** |
|
|
|
|
|
--- |
|
|
|
|
|
## 📝 **Technical Details** |
|
|
|
|
|
- **Framework**: Gradio 4.44.0 |
|
|
- **Language**: Python 3.9+ |
|
|
- **Architecture**: Async multi-agent system |
|
|
- **APIs**: DuckDuckGo, Pollinations, OpenAI, Anthropic, Google |
|
|
- **Deployment**: Hugging Face Spaces |
|
|
- **License**: MIT |
|
|
|
|
|
## 🏷️ **Tags** |
|
|
|
|
|
`agent-demo-track` `education` `ai-agents` `course-generation` `multi-tool` `web-research` `image-generation` `gradio` `hackathon` |
|
|
|
|
|
--- |
|
|
|
|
|
**Made with ❤️ by Pink Pixel** | **Hugging Face Agent Hackathon 2025** | **Track 3: Agentic Demo** |
