https://github.com/ibz-04/hudgent
Official code implementation for my ready tensor publication, an ai agent that retrieves data from an islamic website -> uses the data as alignment criteria to answer the user
https://github.com/ibz-04/hudgent
ai-agent ai-alignment cython islamic-ai-agent open-source python search-agent turkish-nlp webcrawler whoosh
Last synced: 1 day ago
JSON representation
Official code implementation for my ready tensor publication, an ai agent that retrieves data from an islamic website -> uses the data as alignment criteria to answer the user
- Host: GitHub
- URL: https://github.com/ibz-04/hudgent
- Owner: iBz-04
- Created: 2025-03-05T20:51:22.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-04-22T21:10:04.000Z (6 months ago)
- Last Synced: 2025-04-22T22:24:26.419Z (5 months ago)
- Topics: ai-agent, ai-alignment, cython, islamic-ai-agent, open-source, python, search-agent, turkish-nlp, webcrawler, whoosh
- Language: Python
- Homepage: https://app.readytensor.ai/publications/54Pa6CrvBvjU
- Size: 32.3 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Islamic AI Agent System
An AI-powered q & 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.
## Preview
## Key Features
- **Q&A Interface**: Natural language interface for asking Islamic-related questions
- **Context-Aware Answers**: AI responses grounded in verified Islamic content
- **Knowledge Base**:
- Pre-loaded sample data covering fasting (Oruç), Ramadan, and prayer (Dua)
- Web crawler integration for [islamveihsan.com](https://www.islamveihsan.com/)
- **Search Index**: Fast content retrieval system using Whoosh search engine
- **Validation System**: Ensures answers stay within provided Islamic context
- **Batch Processing**: Automated setup script for data/index preparation
## Working Principle
The system operates in 3 phases:
1. **Data Preparation**: Creates sample data & crawls a given websites
2. **Index Building**: Creates searchable knowledge base
3. **Q&A Interface**: Interactive Islamic knowledge assistant
```bash
# Start the system (Windows) - Optional
.\run_project.bat
# Run project (Windows)
Python main.py
# Or run manually:
python create_sample_data.py
python indexer/build_index.py
python main.py
```
## Architecture Components 🧠
- `create_sample_data.py`: Creates initial dataset with Islamic rulings
- `indexer/`: Search index builder using Whoosh
- `crawler/`: Website spider for islamveihsan.com
- `main.py`: Core AI response generation
- `config/`: Contains API and website configurations
## Author
- `Ibrahim` : @iBz-04