Skip to main content

Generate Islamic Friday sermons (khutbah) using AI (#GodamSahur 2025)

Project description

khutbahmaker

Generate Islamic Friday sermons (khutbah) using AI (#GodamSahur 2025).

KhutbahMaker Web UI

Installation

pip install khutbahmaker

Key Features

  • 📝 Content Generation
    • Topic-based Khutbah Generation
    • Multiple Language Support
    • Adjustable Length Options
    • Various Tone Settings
  • 📊 Output Formats
    • Professional PDF Generation
    • Clean Markdown Text
    • RTL Support for Arabic
    • Beautiful Typography
  • 🌐 Flexible Integration
    • Interactive Web UI
    • Python Library
    • Customizable Settings

Usage

Python Library

from khutbahmaker import KhutbahMaker

# Initialize
client = KhutbahMaker(
    mode="default",                               # Mode (default/webui)
    api_key="YOUR_KEY",                           # AI service API key
    model="gemini-2.0-flash-thinking-exp-01-21"   # AI model to use
    timeout=180                                   # AI request timeout in seconds
)

# Generate khutbah
pdf_file, markdown_text = client.generate_khutbah(
    topic="Ramadan Preparation",   # Main topic/theme
    length="Short",                # short/medium/long
    tone="Inspirational",          # Tone of the khutbah
    language="Bahasa Malaysia"     # Target language
)

Web UI

Start the Gradio web interface:

client = KhutbahMaker(mode="webui")
# OR
client.start_webui(
    host="localhost",    # Server host
    port=7860,           # Server port
    browser=False,       # Launch browser
    upload_size="4MB",   # Max upload size
    public=False,        # Enable public URL
    limit=10,            # Max concurrent requests
    quiet=False          # Quiet mode
)

Configuration

Target Languages

  • Bahasa Malaysia
  • Arabic
  • English
  • Mandarin
  • Tamil

Khutbah Lengths

  • Short: 10-15 minutes
  • Medium: 15-20 minutes
  • Long: 20-30 minutes

Tone Options

  • Scholarly
  • Inspirational
  • Practical
  • Reflective
  • Motivational
  • Educational
  • Historical
  • Narrative

PDF Result Format

  • Professional Title
  • Opening Praises
  • Quranic Verses & Hadith
  • Main Content
  • Practical Advice
  • Closing Prayers
  • RTL Support for Arabic

License

See LICENSE for details.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page