Instructions to use Edraky/Edraky-AI with libraries, inference providers, notebooks, and local apps. Follow these links to get started.

Libraries

How to use Edraky/Edraky-AI with Transformers:

# Use a pipeline as a high-level helper
from transformers import pipeline

pipe = pipeline("text-generation", model="Edraky/Edraky-AI")
messages = [
    {"role": "user", "content": "Who are you?"},
]
pipe(messages)

# Load model directly
from transformers import AutoTokenizer, AutoModelForCausalLM

tokenizer = AutoTokenizer.from_pretrained("Edraky/Edraky-AI")
model = AutoModelForCausalLM.from_pretrained("Edraky/Edraky-AI")
messages = [
    {"role": "user", "content": "Who are you?"},
]
inputs = tokenizer.apply_chat_template(
	messages,
	add_generation_prompt=True,
	tokenize=True,
	return_dict=True,
	return_tensors="pt",
).to(model.device)

outputs = model.generate(**inputs, max_new_tokens=40)
print(tokenizer.decode(outputs[0][inputs["input_ids"].shape[-1]:]))

Notebooks
Google Colab
Kaggle
Local Apps

vLLM

How to use Edraky/Edraky-AI with vLLM:

Install from pip and serve model

# Install vLLM from pip:
pip install vllm
# Start the vLLM server:
vllm serve "Edraky/Edraky-AI"
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:8000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "Edraky/Edraky-AI",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Use Docker

docker model run hf.co/Edraky/Edraky-AI

SGLang

How to use Edraky/Edraky-AI 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 "Edraky/Edraky-AI" \
    --host 0.0.0.0 \
    --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "Edraky/Edraky-AI",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

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 "Edraky/Edraky-AI" \
        --host 0.0.0.0 \
        --port 30000
# Call the server using curl (OpenAI-compatible API):
curl -X POST "http://localhost:30000/v1/chat/completions" \
	-H "Content-Type: application/json" \
	--data '{
		"model": "Edraky/Edraky-AI",
		"messages": [
			{
				"role": "user",
				"content": "What is the capital of France?"
			}
		]
	}'

Docker Model Runner
How to use Edraky/Edraky-AI with Docker Model Runner:
```
docker model run hf.co/Edraky/Edraky-AI
```
Browse Quantizations to use this model in llama.cpp, Ollama, LM Studio, or any compatible app.

🤖 إدراكي (Edraky) - Multilingual Educational AI Model 🇪🇬

Edraky is a fine-tuned multilingual model built on Qwen2-1.5B-Instruct, designed to provide educational support for Arabic-speaking students, especially targeting Egypt's 3rd preparatory curriculum. It supports Arabic, English, and Hebrew to ensure flexible, broad usage in multilingual environments.

🧠 About Edraky

Edraky is part of the "إدراكي" educational initiative to democratize access to AI-powered tools for students in Egypt and the broader Arab world. By fine-tuning the powerful Qwen2 base model, Edraky delivers context-aware, curriculum-aligned, and interactive responses that help learners understand core subjects such as:

اللغة العربية (Arabic Language)
الدراسات الاجتماعية (Social Studies)
العلوم (Science)
الرياضيات (Math)
حاسب آلي (Computer)
اللغة الإنجليزية (English)

🚀 Key Features

🤖 Text Generation & Q&A: Answer student questions in an educational and child-safe manner.
📖 Curriculum Support: Focused especially on 3rd preparatory grade in Egypt.
🌍 Multilingual Input: Supports Arabic, English, and Hebrew.
🔀 Open-Source: Available for research, personal, or educational use.
📚 Trained on curated educational prompts for logic, language understanding, and curriculum-based queries.

🧪 Training & Fine-Tuning

Base model: Qwen/Qwen2-1.5B-Instruct

Training Data Sources:

fka/awesome-chatgpt-prompts
gsm8k-rerun/Qwen_Qwen2.5-1.5B-Instruct
Additional data created from Arabic curriculum-style questions and student textbooks

Training Methodology:

Supervised fine-tuning
Prompt-optimized inputs
Tokenized using Hugging Face’s tokenizer compatible with Qwen2 models

🔍 Evaluation

Model was evaluated on:

✔️ Accuracy for subject-specific answers
✔️ Perplexity for fluency and coherence
✔️ WER (Word Error Rate) for language understanding

Evaluation still in progress for full benchmarks — to be published soon.

🧑‍💻 Example Usage

from transformers import AutoModelForCausalLM, AutoTokenizer
model = AutoModelForCausalLM.from_pretrained("Edraky/Edraky-AI")
tokenizer = AutoTokenizer.from_pretrained("Edraky/Edraky-AI")
prompt = "اشرح الثورة العرابية بإيجاز"
inputs = tokenizer(prompt, return_tensors="pt")
output = model.generate(**inputs, max_new_tokens=150)
print(tokenizer.decode(output[0], skip_special_tokens=True))

🧑‍📓 Intended Use

💬 Classroom support AI assistant
✍️ Writing and summarization in Arabic
❓ Question answering for exam preparation
🔍 Fact recall for historical, literary, and social studies content

❌ Not Intended For:

❌ Political or religious fatwa content
❌ Personal decision-making
❌ Generating offensive or misleading answers

🌱 Future Plans

✅ Add voice input/output via Whisper integration
✅ Online quiz companion
✅ Add visual aids (diagrams, maps)
✅ Full web platform integration (see edraky.rf.gd)

📢 Maintainers

Developed by: Edraky AI Team
🌐 Website: https://edraky.rf.gd
📧 Contact: edraky.help@gmail.com

📜 Citation

@misc{edraky2025,
  title={Edraky: Multilingual Educational AI Model},
  author={Edraky Team},
  year={2025},
  howpublished={\url{https://huggingface.co/Edraky/Edraky}}
}

هذا المشروع من أجل دعم التعليم في مصر باستخدام الذكاء الاصطناعي. نرجو أن يكون مفيدًا لجميع الطلاب والمعلمين 🌟

Downloads last month: 30

Safetensors

Model size

2B params

Tensor type

BF16

Model tree for Edraky/Edraky-AI

Base model

Qwen/Qwen2-1.5B-Instruct

Finetuned

(122)

this model

Quantizations

1 model

Edraky
/

Edraky-AI