{"id":26538885,"url":"https://github.com/ibz-04/hudgent","last_synced_at":"2025-10-03T14:40:22.852Z","repository":{"id":281065968,"uuid":"943518708","full_name":"iBz-04/Hudgent","owner":"iBz-04","description":"Official code implementation for my ready tensor publication, an ai agent that retrieves data from an islamic website -\u003e uses the data as alignment criteria to answer the user","archived":false,"fork":false,"pushed_at":"2025-04-22T21:10:04.000Z","size":33882,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-22T22:24:26.419Z","etag":null,"topics":["ai-agent","ai-alignment","cython","islamic-ai-agent","open-source","python","search-agent","turkish-nlp","webcrawler","whoosh"],"latest_commit_sha":null,"homepage":"https://app.readytensor.ai/publications/54Pa6CrvBvjU","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/iBz-04.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-03-05T20:51:22.000Z","updated_at":"2025-04-22T21:10:12.000Z","dependencies_parsed_at":"2025-04-22T22:32:37.373Z","dependency_job_id":null,"html_url":"https://github.com/iBz-04/Hudgent","commit_stats":null,"previous_names":["ibz-04/hudgent"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/iBz-04/Hudgent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iBz-04%2FHudgent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iBz-04%2FHudgent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iBz-04%2FHudgent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iBz-04%2FHudgent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iBz-04","download_url":"https://codeload.github.com/iBz-04/Hudgent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iBz-04%2FHudgent/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262102404,"owners_count":23259249,"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":["ai-agent","ai-alignment","cython","islamic-ai-agent","open-source","python","search-agent","turkish-nlp","webcrawler","whoosh"],"created_at":"2025-03-21T23:30:30.112Z","updated_at":"2025-10-03T14:40:22.780Z","avatar_url":"https://github.com/iBz-04.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Islamic AI Agent System\n\nAn AI-powered q \u0026 a agent system focused on Islamic knowledge, leveraging scraped content from authentic sources and OpenAI's NLP capabilities. The system provides context-aware answers about Islamic practices, beliefs, and traditions while maintaining source fidelity.\n\n## Preview\n\n\u003cimg src=\"https://res.cloudinary.com/diekemzs9/image/upload/v1741292644/Screenshot_2025-03-06_191123_m0nrti.png\" alt=\"My Image\" width=\"950\"/\u003e\n\n## Key Features \n\n- **Q\u0026A Interface**: Natural language interface for asking Islamic-related questions\n- **Context-Aware Answers**: AI responses grounded in verified Islamic content\n- **Knowledge Base**:\n  - Pre-loaded sample data covering fasting (Oruç), Ramadan, and prayer (Dua)\n  - Web crawler integration for [islamveihsan.com](https://www.islamveihsan.com/)\n- **Search Index**: Fast content retrieval system using Whoosh search engine\n- **Validation System**: Ensures answers stay within provided Islamic context\n- **Batch Processing**: Automated setup script for data/index preparation\n\n\n\n## Working Principle\nThe system operates in 3 phases:\n1. **Data Preparation**: Creates sample data \u0026 crawls a given  websites\n2. **Index Building**: Creates searchable knowledge base\n3. **Q\u0026A Interface**: Interactive Islamic knowledge assistant\n\n```bash\n# Start the system (Windows) - Optional\n.\\run_project.bat\n\n# Run project (Windows)\nPython main.py\n\n\n\n# Or run manually:\npython create_sample_data.py\npython indexer/build_index.py\npython main.py\n```\n\n## Architecture Components 🧠\n- `create_sample_data.py`: Creates initial dataset with Islamic rulings\n- `indexer/`: Search index builder using Whoosh\n- `crawler/`: Website spider for islamveihsan.com\n- `main.py`: Core AI response generation\n- `config/`: Contains API and website configurations\n\n## Author \n\n- `Ibrahim` : @iBz-04","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibz-04%2Fhudgent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fibz-04%2Fhudgent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibz-04%2Fhudgent/lists"}