A user-friendly application for exploring the Holy Quran through its English translation, built with Python and Gradio.

• Keyword Search: Search for specific words or phrases across the entire Quran
• Statistical Analysis: View visualizations and statistics about Quran's structure
• Multilingual Surah Explorer:
  • Read complete Surahs in Arabic, Urdu, and English
  • Side-by-side translation comparison
  • Word cloud visualizations
  • RTL support for Arabic text

A collection of interactive notebooks providing statistical insights about the Quran:

• Word frequency distributions
• Verse length analysis
• Surah-wise statistics
• Pattern analysis
• Visualization of Quranic data

An intuitive web interface for searching Quranic verses:

• Search by keywords
• Find specific verses and their translations
• Get verse context and metadata
• User-friendly interface powered by Gradio

.
├── datasets/               # Dataset files
│   ├── en.yusufali.csv    # English translation
│   ├── Arabic-Original.csv # Original Arabic text
│   ├── Urdu.csv           # Urdu translation
│   └── surah_names_english.csv
├── src/                   # Source code
│   ├── components/        # Modular components
│   │   ├── search_tab.py  # Search functionality
│   │   ├── statistics_tab.py # Statistics and visualizations
│   │   ├── surah_tab.py   # Surah display
│   │   └── utils.py       # Shared utilities
│   ├── styles/           # Styling
│   │   └── styles.css     # CSS styles
│   └── gradio_app.py     # Main application
└── word_cloud/           # Word cloud images for each Surah

• Python 3.7+
• gradio
• pandas
• matplotlib
• seaborn
• re

1. Clone the repository
2. Install dependencies:

pip install gradio pandas matplotlib seaborn

Navigate to the project directory and run:

python src/gradio_app.py

The application will be available at http://localhost:7860 by default.

1. Create new components in the src/components/ directory
2. Update styles in src/styles/styles.css
3. Import and integrate components in src/gradio_app.py

• Each tab's functionality is contained in a separate module
• Shared utilities are in utils.py
• CSS styling is centralized in styles.css

• Follow the existing code structure
• Add appropriate documentation
• Test new features thoroughly
• Update README.md when adding new features

Open source under MIT License

• Quran translation: Yusuf Ali
• Application development: alamshoaib134@gmail.com