course-creator-ai / README.md
sizzlebop's picture
Update README.md
583a8ef verified

A newer version of the Gradio SDK is available: 5.44.0

Upgrade
metadata
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


๐Ÿš€ 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


๐Ÿ“ 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