Text Generation
Transformers
Safetensors
English
t5
text2text-generation
english
quran
islamic
religious-texts
question-answering
text-generation-inference
Instructions to use justdeen/QuranPlus with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Transformers
How to use justdeen/QuranPlus with Transformers:
# Use a pipeline as a high-level helper from transformers import pipeline pipe = pipeline("text-generation", model="justdeen/QuranPlus")# Load model directly from transformers import AutoTokenizer, AutoModelForSeq2SeqLM tokenizer = AutoTokenizer.from_pretrained("justdeen/QuranPlus") model = AutoModelForSeq2SeqLM.from_pretrained("justdeen/QuranPlus", device_map="auto") - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- vLLM
How to use justdeen/QuranPlus with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "justdeen/QuranPlus" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "justdeen/QuranPlus", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker
docker model run hf.co/justdeen/QuranPlus
- SGLang
How to use justdeen/QuranPlus with SGLang:
Install from pip and serve model
# Install SGLang from pip: pip install sglang # Start the SGLang server: python3 -m sglang.launch_server \ --model-path "justdeen/QuranPlus" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "justdeen/QuranPlus", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }'Use Docker images
docker run --gpus all \ --shm-size 32g \ -p 30000:30000 \ -v ~/.cache/huggingface:/root/.cache/huggingface \ --env "HF_TOKEN=<secret>" \ --ipc=host \ lmsysorg/sglang:latest \ python3 -m sglang.launch_server \ --model-path "justdeen/QuranPlus" \ --host 0.0.0.0 \ --port 30000 # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:30000/v1/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "justdeen/QuranPlus", "prompt": "Once upon a time,", "max_tokens": 512, "temperature": 0.5 }' - Docker Model Runner
How to use justdeen/QuranPlus with Docker Model Runner:
docker model run hf.co/justdeen/QuranPlus
| { | |
| "status": "interrupted", | |
| "timestamp": "2025-07-11T06:17:00.185708", | |
| "metrics": { | |
| "achieved_rouge1": 0.9989, | |
| "note": "Training was interrupted but model achieved excellent performance" | |
| }, | |
| "config": { | |
| "data": { | |
| "quran_data_path": "/kaggle/input/quran-q-and-a-training-dataset/quran-qa-dataset/raw_data", | |
| "output_dir": "/kaggle/working/processed_data", | |
| "training_data_file": "training_data.json", | |
| "validation_split": 0.2, | |
| "max_sequence_length": 384, | |
| "supported_languages": [ | |
| "en", | |
| "ar" | |
| ] | |
| }, | |
| "model": { | |
| "base_model": "google/flan-t5-small", | |
| "model_name": "quran-qa-flan-t5-small-v2", | |
| "max_input_length": 384, | |
| "max_target_length": 128 | |
| }, | |
| "training": { | |
| "batch_size": 2, | |
| "gradient_accumulation_steps": 16, | |
| "learning_rate": 0.0003, | |
| "num_epochs": 3, | |
| "warmup_steps": 100, | |
| "weight_decay": 0.01, | |
| "adam_epsilon": 1e-08, | |
| "max_grad_norm": 1.0, | |
| "save_steps": 100, | |
| "eval_steps": 100, | |
| "logging_steps": 50 | |
| }, | |
| "kaggle": { | |
| "use_cpu_only": true, | |
| "memory_efficient": true, | |
| "max_training_samples": 1500 | |
| }, | |
| "huggingface": { | |
| "model_repo": "quran-qa-model-v2", | |
| "private_repo": false, | |
| "push_to_hub": false | |
| } | |
| } | |
| } |