README.md

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