{"id":20765951,"url":"https://github.com/codewithdark-git/sheikhgpt","last_synced_at":"2025-07-04T06:34:23.950Z","repository":{"id":261788093,"uuid":"859275093","full_name":"codewithdark-git/SheikhGPT","owner":"codewithdark-git","description":"Welcome to SheikhGPT, a Streamlit-powered Islamic content generation tool. The app allows users to interact with Islamic teachings through Quran recitations, Hadith retrieval, and custom Islamic content generation.","archived":false,"fork":false,"pushed_at":"2024-11-08T12:36:11.000Z","size":532,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-11T18:54:30.065Z","etag":null,"topics":["app","g4f","gpt","gpt-4","gpt4o","hadith-api","islamic","islamic-apps","llm","o1","python","python3","recitations","streamlit","streamlit-application"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codewithdark-git.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-18T11:45:53.000Z","updated_at":"2024-11-08T12:36:15.000Z","dependencies_parsed_at":"2024-11-08T13:19:15.064Z","dependency_job_id":"0bb8cbde-d91c-4ae8-b701-45db503782b7","html_url":"https://github.com/codewithdark-git/SheikhGPT","commit_stats":null,"previous_names":["codewithdark-git/sheikhgpt"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/codewithdark-git/SheikhGPT","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codewithdark-git%2FSheikhGPT","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codewithdark-git%2FSheikhGPT/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codewithdark-git%2FSheikhGPT/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codewithdark-git%2FSheikhGPT/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codewithdark-git","download_url":"https://codeload.github.com/codewithdark-git/SheikhGPT/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codewithdark-git%2FSheikhGPT/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263463133,"owners_count":23470447,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["app","g4f","gpt","gpt-4","gpt4o","hadith-api","islamic","islamic-apps","llm","o1","python","python3","recitations","streamlit","streamlit-application"],"created_at":"2024-11-17T11:20:09.021Z","updated_at":"2025-07-04T06:34:23.920Z","avatar_url":"https://github.com/codewithdark-git.png","language":"Python","readme":"# **SheikhGPT **\n\nWelcome to **SheikhGPT**, a Streamlit-powered Islamic content generation tool. The app allows users to interact with Islamic teachings through Quran recitations, Hadith retrieval, and custom Islamic content generation.\n\n## **1. Overview**\n\nSheikhGPT provides three main functionalities:\n- **Quran Recitation**: Listen to Quran recitations in Arabic with Urdu translation.\n- **Hadith Retrieval**: Search for Hadiths by topics, with Arabic and Urdu translations, and references.\n- **Islamic Content Generation**: Ask Islamic questions and receive answers in your chosen language.\n\n## **2. App Structure**\n\nThe app is divided into several sections:\n\n### **2.1 Main Page**\n- **Title**: Displays \"SheikhGPT\" with an icon.\n- **Navigation Links**:\n  - **Quran Recitation**: Directs users to the Quran recitation section.\n  - **Hadith**: Allows users to search for Hadiths.\n\n### **2.2 Sidebar**\n- **Language Selection**: Choose your input and output language for the content generation.\n- **Settings**: Manage and review your favorite responses and export your chat history.\n  \n### **2.3 Chat Interface**\n- **Text Input**: Users can type their Islamic questions here.\n- **Speech Input**: Click the microphone button to ask your question using speech recognition.\n- **Generated Responses**: SheikhGPT will answer your question using its language model.\n\n### **2.4 Favorites**\n- **Add to Favorites**: Users can mark responses as favorites and manage them from the sidebar.\n- **View Favorites**: Users can expand a list of favorite responses in the sidebar.\n\n## **3. Features**\n\n### **3.1 Quran Recitation**\n**How to Use:**\n1. Navigate to the **Quran Recitation** page from the home screen.\n2. Select a **Surah** from the dropdown list.\n3. Specify the **Ayah range** (start and end Ayahs).\n4. Choose your preferred **reciter** from the dropdown.\n5. Click **Play Recitation**. The app will fetch the Quran recitation in Arabic along with its Urdu translation.\n6. The recitation will play in the app's audio player, and the Urdu translation will be displayed.\n\n### **3.2 Hadith Retrieval**\n**How to Use:**\n1. Navigate to the **Hadith** section.\n2. Enter a query like \"prayer\" or \"fasting.\"\n3. Click **Fetch Hadith**.\n4. The app will return at least five Hadiths in Arabic with Urdu translations, alongside references.\n\n### **3.3 Islamic Content Generation**\n**How to Use:**\n1. Type your Islamic question in the chat input (or use speech-to-text).\n2. SheikhGPT will translate your question into English, process it, and generate a response.\n3. The response will be translated back into your chosen language (from the settings sidebar) and displayed.\n4. Mark any response as a **Favorite** using the star button for quick access later.\n\n## **4. Additional Features**\n\n### **4.1 Export Chat History**\n- Users can download the chat history in JSON format using the **Export Chat History** button in the sidebar.\n\n### **4.2 Clear Data**\n- Clear the chat history or your favorites using the respective buttons in the sidebar.\n\n## **5. Error Handling**\nIf you encounter any issues, such as a missing recitation or invalid input, appropriate error messages will be displayed. Check if the inputs (Surah, Ayah range, and reciter) are correct, and try again.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodewithdark-git%2Fsheikhgpt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodewithdark-git%2Fsheikhgpt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodewithdark-git%2Fsheikhgpt/lists"}