README.md

metadata

title: Arabic Story Content Moderator
emoji: 📝
colorFrom: blue
colorTo: green
sdk: docker
sdk_version: 3.11.0
app_file: app.py
pinned: false

Arabic Story Content Moderator

An AI-powered content moderation service for Arabic short stories that checks for cultural violations and inappropriate content using the Deepseek API.

🌟 Features

• Cultural Sensitivity: Checks stories against Arabic and Islamic cultural norms
• Content Safety: Detects inappropriate sexual content, excessive violence, and profanity
• Real-time Moderation: Fast API response for instant content validation
• Batch Processing: Support for moderating multiple stories at once
• Arabic Language Support: Specialized for Arabic text processing

🚀 API Endpoints

POST /moderate

Moderate a single Arabic story.

Request:

{
    "story_content": "نص القصة العربية هنا"
}

Response:

{
    "approved": true,
    "response": "true",
    "timestamp": "2024-01-15T10:30:00"
}

POST /moderate/batch

Moderate multiple stories at once.

Request:

{
    "stories": ["قصة أولى", "قصة ثانية", "قصة ثالثة"]
}

GET /health

Check service health status.

📋 Response Format

The API returns consistent responses:

• approved: Boolean indicating if content is approved
• response: String value "true" (approved) or "no" (rejected)
• timestamp: ISO timestamp of the moderation
• reason: Description if content is rejected

🔧 Moderation Criteria

1. Cultural and Religious Content

• No mockery of Islamic religion or Arabic traditions
• Respect for religious and social symbols
• Adherence to Islamic values

2. Sexual Content and Violence

• No explicit sexual content or suggestive material
• No excessive or graphic violence
• No profanity or inappropriate language

3. Sensitive Political Content

• No sectarian or ethnic incitement
• Avoidance of controversial political topics

4. Social Values

• Respect for family and community values
• No promotion of socially destructive behaviors

🛠️ Integration Example

cURL Example

curl -X POST "https://your-huggingface-space-url/moderate" \
  -H "Content-Type: application/json" \
  -d '{"story_content": "قصة قصيرة عن الصداقة والوفاء"}'

Python Example

import requests

url = "https://your-huggingface-space-url/moderate"
data = {
    "story_content": "نص القصة العربية"
}

response = requests.post(url, json=data)
result = response.json()

if result["approved"]:
    print("Story approved for posting")
else:
    print("Story violates community guidelines")

📝 Setup Instructions

Environment Variables

Set your Deepseek API key as an environment variable:

DEEPSEEK_API_KEY=your_deepseek_api_key_here

Local Testing

pip install -r requirements.txt
export DEEPSEEK_API_KEY=your_api_key
python app.py

🔒 Privacy and Security

• Stories are processed in real-time and not stored
• API communications are encrypted
• No personal data is retained
• Compliant with data protection standards

📈 Performance

• Average response time: < 2 seconds
• Supports concurrent requests
• Optimized for Arabic text processing
• Scalable architecture

🤝 Integration with .NET Backend

This service is designed to integrate seamlessly with your .NET story posting API. When a user attempts to post a story, send it to this moderation service first.

📞 Support

For technical support or questions about the moderation criteria, please refer to the documentation or contact the development team.

---

Made with ❤️ for the Arabic literary community