Upload 5 files

.gitattributes

@@ -1,35 +1,35 @@
-*.7z filter=lfs diff=lfs merge=lfs -text
-*.arrow filter=lfs diff=lfs merge=lfs -text
-*.bin filter=lfs diff=lfs merge=lfs -text
-*.bz2 filter=lfs diff=lfs merge=lfs -text
-*.ckpt filter=lfs diff=lfs merge=lfs -text
-*.ftz filter=lfs diff=lfs merge=lfs -text
-*.gz filter=lfs diff=lfs merge=lfs -text
-*.h5 filter=lfs diff=lfs merge=lfs -text
-*.joblib filter=lfs diff=lfs merge=lfs -text
-*.lfs.* filter=lfs diff=lfs merge=lfs -text
-*.mlmodel filter=lfs diff=lfs merge=lfs -text
-*.model filter=lfs diff=lfs merge=lfs -text
-*.msgpack filter=lfs diff=lfs merge=lfs -text
-*.npy filter=lfs diff=lfs merge=lfs -text
-*.npz filter=lfs diff=lfs merge=lfs -text
-*.onnx filter=lfs diff=lfs merge=lfs -text
-*.ot filter=lfs diff=lfs merge=lfs -text
-*.parquet filter=lfs diff=lfs merge=lfs -text
-*.pb filter=lfs diff=lfs merge=lfs -text
-*.pickle filter=lfs diff=lfs merge=lfs -text
-*.pkl filter=lfs diff=lfs merge=lfs -text
-*.pt filter=lfs diff=lfs merge=lfs -text
-*.pth filter=lfs diff=lfs merge=lfs -text
-*.rar filter=lfs diff=lfs merge=lfs -text
-*.safetensors filter=lfs diff=lfs merge=lfs -text
-saved_model/**/* filter=lfs diff=lfs merge=lfs -text
-*.tar.* filter=lfs diff=lfs merge=lfs -text
-*.tar filter=lfs diff=lfs merge=lfs -text
-*.tflite filter=lfs diff=lfs merge=lfs -text
-*.tgz filter=lfs diff=lfs merge=lfs -text
-*.wasm filter=lfs diff=lfs merge=lfs -text
-*.xz filter=lfs diff=lfs merge=lfs -text
-*.zip filter=lfs diff=lfs merge=lfs -text
-*.zst filter=lfs diff=lfs merge=lfs -text
-*tfevents* filter=lfs diff=lfs merge=lfs -text
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,4 @@
+*.pyc
+__pycache__/
+.DS_Store
+.env

app.py

@@ -1,39 +1,47 @@
 import gradio as gr
-from components.utils import load_data, load_css, get_surah_names_list
-from components.search_tab import create_search_tab
-from components.statistics_tab import create_statistics_tab
-from components.surah_tab import create_surah_tab
+import os
 
-def main():
-    """
-    Main function to create and launch the Quran Explorer application.
-    The app provides three main features:
-    1. Keyword search across the Quran
-    2. Statistical analysis and visualizations
-    3. Surah-wise exploration with word clouds
-    """
-    # Load data
-    quran_data, surah_names = load_data()
-    surah_names_list = get_surah_names_list(surah_names)
+# ...existing code...
+
+def load_surah(surah_name, surah_number):
+    # Load the verses from a file or a predefined dictionary
+    # For simplicity, let's assume we have a dictionary `surah_verses`
+    surah_verses = {
+        "Al-Kahf": ["Verse 1", "Verse 2", "Verse 3", "..."]
+        # Add other surahs here
+    }
+    verses = surah_verses.get(surah_name, [])
     
-    # Create the Gradio interface
-    with gr.Blocks(css=load_css()) as iface:
-        gr.Markdown("""
-        # Quran Explorer
-        Welcome to the Quran Explorer application. This tool provides multiple ways to explore 
-        and understand the Holy Quran through its English translation. Use the tabs below to:
-        - Search for specific words or phrases
-        - View statistical insights and visualizations
-        - Read complete Surahs with word cloud visualizations
-        """)
-        
-        # Create tabs
-        search_tab = create_search_tab(quran_data)
-        statistics_tab = create_statistics_tab(quran_data)
-        surah_tab = create_surah_tab(quran_data, surah_names_list)
+    # Load the word cloud image path
+    word_cloud_path = f"plots/{surah_name} word cloud.png"
     
-    # Launch the interface
-    iface.launch(share=True)
+    return verses, word_cloud_path
+
+def display_surah(surah_name, surah_number):
+    verses, word_cloud_path = load_surah(surah_name, surah_number)
+    verses_text = "\n".join(verses)
+    return verses_text, word_cloud_path
+
+# Create a list of surah names and numbers
+surah_names = ["Al-Kahf", "Another Surah"]  # Add all surah names here
+surah_numbers = list(range(1, 115))  # Surah numbers from 1 to 114
+
+with gr.Blocks() as demo:
+    with gr.Tabs():
+        with gr.TabItem("Word Cloud"):
+            # ...existing code for word cloud tab...
+            pass
+        
+        with gr.TabItem("Surah Viewer"):
+            surah_name = gr.Dropdown(label="Surah Name", choices=surah_names)
+            surah_number = gr.Dropdown(label="Surah Number", choices=surah_numbers)
+            verses_output = gr.Textbox(label="Verses", lines=20)
+            word_cloud_output = gr.Image(label="Word Cloud")
+            
+            gr.Button("Load Surah").click(
+                display_surah, 
+                inputs=[surah_name, surah_number], 
+                outputs=[verses_output, word_cloud_output]
+            )
 
-if __name__ == "__main__":
-    main()
+demo.launch()

readme.md

@@ -0,0 +1,107 @@
+# Al-Quran Repository
+A user-friendly application for exploring the Holy Quran through its English translation, built with Python and Gradio.
+
+
+## Features
+
+- **Keyword Search**: Search for specific words or phrases across the entire Quran
+- **Statistical Analysis**: View visualizations and statistics about Quran's structure
+- **Surah Explorer**: Read complete Surahs with word cloud visualizations
+
+### 1. Quranic Analysis (Jupyter Notebooks)
+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
+![Quran Word Cloud](https://github.com/user-attachments/assets/f4cb7157-fcda-4e9a-b6fb-6d9d1aaeca29)
+![Descriptive Statistics of Ayah Count per Surah](https://github.com/user-attachments/assets/bce97fb9-15fe-4e73-ab78-bf7e8ce4e3e4)
+
+### 2. Verse Search Interface (Gradio App)
+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
+<img width="2056" alt="Screenshot 2025-03-08 at 3 53 52 AM" src="https://github.com/user-attachments/assets/7903305f-5b01-4866-8541-ef6a73b887e8" />
+
+<img width="2056" alt="Screenshot 2025-03-08 at 3 54 09 AM" src="https://github.com/user-attachments/assets/ea1732e7-656b-43fe-9eb5-59ed98b3a3ca" />
+
+
+
+## Project Structure
+
+```
+.
+├── datasets/               # Dataset files
+│   ├── en.yusufali.csv    # English 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
+```
+
+## Dependencies
+
+- Python 3.7+
+- gradio
+- pandas
+- matplotlib
+- seaborn
+- re
+
+## Installation
+
+1. Clone the repository
+2. Install dependencies:
+```bash
+pip install gradio pandas matplotlib seaborn
+```
+
+## Running the Application
+
+Navigate to the project directory and run:
+
+```bash
+python src/gradio_app.py
+```
+
+The application will be available at `http://localhost:7860` by default.
+
+## Contributing
+
+### Adding New Features
+
+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`
+
+### Code Structure
+
+- Each tab's functionality is contained in a separate module
+- Shared utilities are in `utils.py`
+- CSS styling is centralized in `styles.css`
+
+### Guidelines
+
+- Follow the existing code structure
+- Add appropriate documentation
+- Test new features thoroughly
+- Update README.md when adding new features
+
+## License
+
+Open source under MIT License
+
+## Credits
+
+- Quran translation: Yusuf Ali
+- Application development: [email protected]

run_app.command

@@ -0,0 +1,2 @@
+#!/bin/bash
+/Users/salam9/.pyenv/versions/3.12.1/bin/python /Users/salam9/Desktop/quran/src/gradio_app.py