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