Upload 11 files

README.md

@@ -8,121 +8,69 @@ app_file: app.py
 pinned: false
 ---
 
-# راوي (Rawi) - Arabic AI Storytelling Platform
+# رَاوي (Rawi) - منصة القص العربي بالذكاء الاصطناعي 
 
-## Overview
-Rawi is an Arabic AI storytelling platform that leverages DeepSeek AI to generate interactive and immersive stories in Arabic. The platform allows users to configure stories, participate in shaping the narrative, and listen to the stories using text-to-speech capabilities.
-
-## Backend API
-This repository contains the FastAPI backend for the Rawi platform. It provides API endpoints for story generation, continuation, editing, and text-to-speech conversion.
-
-## Features
-- Interactive story generation based on user configuration
-- Complete story generation in a single request
-- Story continuation based on user choices or custom text
-- Text-to-speech conversion for generated stories
-- Story editing capabilities
-
-## Deployment to Hugging Face Spaces
-
-### Steps for Deployment
-1. Create a new Hugging Face Space
-   - Go to [Hugging Face](https://huggingface.co/)
-   - Click on "New Space"
-   - Choose a name for your Space (e.g., "rawi-story-generator")
-   - Select "Docker" as the Space SDK
-   - Choose "CPU" as the hardware
-
-2. Set Up Environment Variables
-   - After creating the Space, go to Settings > Repository Secrets
-   - Add your DeepSeek API key as a secret with the name `DEEPSEEK_API_KEY`
-
-3. Upload Backend Files
-   - Clone your Space repository locally
-   - Copy all files from the `Back-End` directory to the repository
-   - Commit and push your changes
-
-4. Update Frontend API URL
-   - In your frontend `script.js` file, update the `API_URL` to point to your Hugging Face Space:
-     ```javascript
-     const API_URL = 'https://your-space-name.hf.space';
-     ```
-
-5. Deploy Your Frontend
-   - Host your frontend files on a web hosting service (GitHub Pages, Netlify, Vercel, etc.)
-   - Ensure CORS is properly configured in the backend to allow requests from your frontend domain
-
-## Configuration
-The backend can be configured using environment variables:
-
-- `DEEPSEEK_API_KEY`: Your DeepSeek API key (required)
-- `BACKEND_HOST`: Host to bind the server to (default: 0.0.0.0)
-- `BACKEND_PORT`: Port to run the server on (default: 7860)
-- `BASE_URL`: Base URL for the API (default: http://HOST:PORT)
-- `AUDIO_STORAGE_PATH`: Path to store audio files (default: ./audio_files)
+## نظرة عامة
+خدمة API لتوليد قصص عربية تفاعلية باستخدام الذكاء الاصطناعي. تتيح المنصة للمستخدمين إنشاء قصص مخصصة بناءً على معلمات محددة، والتفاعل مع القصة من خلال خيارات متعددة، والاستماع إلى القصص المنشأة بتقنية تحويل النص إلى كلام.
 
-## Development
-To run the backend locally:
+## المميزات
+- إنشاء قصص عربية أصلية باستخدام نماذج الذكاء الاصطناعي من DeepSeek
+- تخصيص معلمات القصة مثل الطول والنوع والشخصيات
+- القص التفاعلي مع خيارات متعددة للمسارات
+- تحويل النص إلى صوت عربي
+- واجهة برمجة تطبيقات RESTful متكاملة
 
-```bash
-# Install dependencies
-pip install -r requirements.txt
+## واجهة برمجة التطبيقات (API)
 
-# Run the server
-uvicorn main:app --reload --host 0.0.0.0 --port 7860
+### تهيئة قصة جديدة
+```
+POST /api/stories/initialize
 ```
 
-## API Endpoints
-- `/api/stories/initialize`: Initialize a new story
-- `/api/stories/complete`: Generate a complete story
-- `/api/stories/continue`: Continue a story based on user choice or custom text
-- `/api/stories/tts`: Generate text-to-speech for a story
-- `/api/stories/edit`: Edit a story based on user instructions
-- `/health`: Check the health status of the API
-
-For detailed API documentation, visit the `/docs` endpoint after deploying the API.
-
----
-
-# راوي - منصة توليد القصص العربية بالذكاء الاصطناعي
-
-## نظرة عامة
-راوي هي منصة لتوليد القصص العربية باستخدام الذكاء الاصطناعي DeepSeek. تتيح المنصة للمستخدمين إعداد القصص، والمشاركة في تشكيل السرد، والاستماع إلى القصص باستخدام تقنية تحويل النص إلى صوت.
+### متابعة القصة
+```
+POST /api/stories/continue
+```
 
-## الخصائص
-- توليد قصص تفاعلية بناءً على إعدادات المستخدم
-- توليد قصة كاملة بطلب واحد
-- متابعة القصة بناءً على اختيارات المستخدم أو نص مخصص
-- تحويل النص إلى صوت للقصص المولدة
-- إمكانيات تعديل القصة
+### تحويل القصة إلى صوت
+```
+POST /api/stories/tts
+```
 
-## التوزيع على Hugging Face Spaces
+### تعديل القصة
+```
+POST /api/stories/edit
+```
 
-### خطوات النشر
-1. إنشاء مساحة جديدة في Hugging Face
-   - انتقل إلى [Hugging Face](https://huggingface.co/)
-   - انقر على "New Space"
-   - اختر اسمًا لمساحتك (مثل "rawi-story-generator")
-   - اختر "Docker" كـ SDK للمساحة
-   - اختر "CPU" كعتاد
+### الحصول على القصة كاملة
+```
+GET /api/stories/story/{story_id}
+```
 
-2. إعداد متغيرات البيئة
-   - بعد إنشاء المساحة، انتقل إلى Settings > Repository Secrets
-   - أضف مفتاح DeepSeek API الخاص بك كسر باسم `DEEPSEEK_API_KEY`
+### الوصول إلى الملفات الصوتية
+```
+GET /audio/{filename}
+```
 
-3. رفع ملفات الواجهة الخلفية
-   - استنسخ مستودع المساحة محليًا
-   - انسخ جميع الملفات من دليل `Back-End` إلى المستودع
-   - قم بتنفيذ الالتزام والدفع للتغييرات
+## فحص الحالة والمعلومات
+```
+GET /health
+```
 
-4. تحديث عنوان URL للواجهة الأمامية
-   - في ملف `script.js` الخاص بالواجهة الأمامية، قم بتحديث `API_URL` ليشير إلى مساحة Hugging Face الخاصة بك:
-     ```javascript
-     const API_URL = 'https://your-space-name.hf.space';
-     ```
+## المتطلبات البيئية
+- `DEEPSEEK_API_KEY`: مفتاح API للوصول إلى نماذج DeepSeek
+- `BACKEND_HOST`: مضيف الخادم (افتراضي: 0.0.0.0)
+- `BACKEND_PORT`: منفذ الخادم (افتراضي: 7860)
+- `BASE_URL`: عنوان URL الأساسي للخدمة
+- `AUDIO_STORAGE_PATH`: مسار تخزين الملفات الصوتية (افتراضي: ./audio_files)
 
-5. نشر الواجهة الأمامية الخاصة بك
-   - استضف ملفات الواجهة الأمامية على خدمة استضافة ويب (GitHub Pages, Netlify, Vercel, إلخ)
-   - تأكد من تكوين CORS بشكل صحيح في الواجهة الخلفية للسماح بالطلبات من نطاق الواجهة الأمامية
+## التكامل مع التطبيقات
+تم تصميم هذه الخدمة للعمل مع:
+1. واجهة المستخدم الويب لـراوي
+2. تطبيق Flutter للأجهزة المحمولة
 
-للحصول على وثائق API مفصلة، قم بزيارة نقطة النهاية `/docs` بعد نشر API. 
+## توثيق واجهة برمجة التطبيقات
+يمكن الوصول إلى وثائق API التفاعلية الكاملة عبر:
+```
+https://[your-space-name].hf.space/docs
+``` 

ai_service.py

@@ -28,68 +28,29 @@ load_dotenv()
 DEEPSEEK_API_KEY = os.getenv("DEEPSEEK_API_KEY")
 DEEPSEEK_API_URL = "https://api.deepseek.com/v1/chat/completions"
 
-# تكوين التسجيل
-logging.basicConfig(level=logging.INFO, 
-                   format='%(asctime)s - %(name)s - %(levelname)s - %(message)s')
-logger = logging.getLogger(__name__)
-
 # تخزين سياق القصص
 # في نظام حقيقي، يجب استخدام قاعدة بيانات بدلاً من التخزين في الذاكرة
 stories_context = {}
 stories_metadata = {}
 
-# تخزين مؤقت للإستجابات المتكررة
-response_cache = {}
-
-
-def timed_lru_cache(seconds: int, maxsize: int = 128):
-    """
-    تخزين مؤقت للدوال مع انتهاء صلاحية بعد وقت محدد
-    """
-    def wrapper_cache(func):
-        func = lru_cache(maxsize=maxsize)(func)
-        func.lifetime = seconds
-        func.expiration = time.time() + seconds
-        
-        @functools.wraps(func)
-        def wrapped_func(*args, **kwargs):
-            if time.time() > func.expiration:
-                func.cache_clear()
-                func.expiration = time.time() + func.lifetime
-                
-            return func(*args, **kwargs)
-            
-        return wrapped_func
-        
-    return wrapper_cache
-
 
 async def generate_response(messages: List[Dict], retries=3, backoff_factor=1.5) -> str:
     """
-    Call DeepSeek API and generate a response based on message chain with retry attempts in case of failure
+    استدعاء DeepSeek API وتوليد استجابة بناءً على سلسلة الرسائل مع محاولة إعادة المحاولة في حالة الفشل
     
     Args:
-        messages: List of conversation messages
-        retries: Number of retry attempts in case of connection failure (default: 3)
-        backoff_factor: Delay factor for consecutive attempts (default: 1.5)
+        messages: قائمة برسائل المحادثة
+        retries: عدد محاولات إعادة المحاولة في حالة فشل الاتصال (افتراضي: 3)
+        backoff_factor: معامل التأخير للمحاولات المتتالية (افتراضي: 1.5)
         
     Returns:
-        str: Response content from API
+        str: محتوى الاستجابة من API
         
     Raises:
-        Exception: In case all attempts fail
+        Exception: في حالة فشل جميع المحاولات
     """
     if not DEEPSEEK_API_KEY:
-        logger.error("API key not available. Please check the environment variables setup.")
-        raise Exception("API key not available. Please check the environment variables setup.")
-    
-    # Generate a cache key from the messages
-    cache_key = hash(str(messages))
-    
-    # Check if we have a cached response
-    if cache_key in response_cache:
-        logger.info("Using cached response")
-        return response_cache[cache_key]
+        raise Exception("مفتاح API غير متوفر. يرجى التحقق من إعداد المتغيرات البيئية.")
         
     headers = {
         "Content-Type": "application/json",
@@ -97,96 +58,70 @@ async def generate_response(messages: List[Dict], retries=3, backoff_factor=1.5)
     }
     
     payload = {
-        "model": "deepseek-chat",
+        "model": "deepseek-chat",  # استبدل باسم النموذج المناسب من DeepSeek API
         "messages": messages,
-        "temperature": 0.75,
-        "max_tokens": 4000
+        "temperature": 0.7,
+        "max_tokens": 1000
     }
     
     last_exception = None
     
-    # Retry connection attempts in case of API failure
+    # محاولات إعادة الاتصال في حالة فشل API
     for attempt in range(retries):
         try:
-            logger.info(f"API call attempt {attempt+1}/{retries}")
-            
             async with httpx.AsyncClient() as client:
                 response = await client.post(
                     DEEPSEEK_API_URL,
                     headers=headers,
                     json=payload,
-                    timeout=120.0  # Increased timeout for longer responses
+                    timeout=60.0
                 )
                 
                 if response.status_code == 429:  # Rate Limit
-                    # Wait before trying again
+                    # انتظار فترة قبل المحاولة مرة أخرى
                     wait_time = backoff_factor * (2 ** attempt)
-                    logger.warning(f"Rate limit exceeded, waiting {wait_time} seconds before retrying.")
+                    print(f"تجاوز حد معدل الطلبات، انتظار {wait_time} ثانية قبل المحاولة مرة أخرى.")
                     await asyncio.sleep(wait_time)
                     continue
                 
                 if response.status_code != 200:
-                    error_msg = f"DeepSeek API request failed: {response.status_code} - {response.text}"
-                    logger.error(error_msg)
+                    error_msg = f"فشل طلب DeepSeek API: {response.status_code} - {response.text}"
+                    print(error_msg)
                     last_exception = Exception(error_msg)
                     
-                    # Wait before trying again
+                    # انتظار فترة قبل المحاولة مرة أخرى
                     wait_time = backoff_factor * (2 ** attempt)
                     await asyncio.sleep(wait_time)
                     continue
                 
                 result = response.json()
                 if "choices" not in result or not result["choices"]:
-                    error_msg = "Invalid DeepSeek API response format"
-                    logger.error(error_msg)
-                    last_exception = Exception(error_msg)
-                    continue
-                
-                content = result["choices"][0]["message"]["content"]
-                
-                # Cache the response for future use (expiring after 1 hour)
-                response_cache[cache_key] = content
-                
-                # Remove old cache entries if cache is too large
-                if len(response_cache) > 100:
-                    # Remove a random entry
-                    response_cache.pop(next(iter(response_cache)))
-                
-                return content
-                
-        except httpx.TimeoutException as e:
-            error_msg = f"API call timed out: {str(e)}"
-            logger.error(error_msg)
-            last_exception = Exception(error_msg)
-            
-            # Wait before trying again
-            wait_time = backoff_factor * (2 ** attempt)
-            await asyncio.sleep(wait_time)
-            continue
+                    raise Exception("تنسيق استجابة DeepSeek API غير صالح")
+                    
+                return result["choices"][0]["message"]["content"]
                 
         except httpx.HTTPError as e:
-            error_msg = f"HTTP connection error: {str(e)}"
-            logger.error(error_msg)
+            error_msg = f"خطأ في اتصال HTTP: {str(e)}"
+            print(error_msg)
             last_exception = Exception(error_msg)
             
-            # Wait before trying again
+            # انتظار فترة قبل المحاولة مرة أخرى
             wait_time = backoff_factor * (2 ** attempt)
             await asyncio.sleep(wait_time)
             continue
             
         except Exception as e:
-            error_msg = f"Unexpected error: {str(e)}"
-            logger.error(error_msg)
+            error_msg = f"خطأ غير متوقع: {str(e)}"
+            print(error_msg)
             last_exception = Exception(error_msg)
             
-            # Wait before trying again
+            # انتظار فترة قبل المحاولة مرة أخرى
             wait_time = backoff_factor * (2 ** attempt)
             await asyncio.sleep(wait_time)
             continue
     
-    # If we got here, all attempts have failed
-    logger.critical(f"API call failed after {retries} attempts")
-    raise last_exception or Exception("Failed to connect to DeepSeek API after multiple attempts")
+    # إذا وصلنا إلى هنا، فقد فشلت جميع المحاولات
+    raise last_exception or Exception("فشل الاتصال بـ DeepSeek API بعد عدة محاولات")
 
 
 def parse_paragraph_and_choices(response_text: str) -> Tuple[str, Optional[List[StoryChoice]]]:
@@ -231,10 +166,29 @@ def parse_paragraph_and_choices(response_text: str) -> Tuple[str, Optional[List[
 
 async def initialize_story(config: StoryConfig) -> StoryResponse:
     """
-    بدء قصة جديدة باستخدام DeepSeek API
+    بدء قصة جديدة بناءً على التكوين المقدم
     """
+    # If this is a non-interactive story, generate the whole story at once
+    if hasattr(config, 'interactive') and not config.interactive:
+        return await generate_complete_story(config)
+    
+    # For interactive stories, continue with the normal flow
     story_id = str(uuid.uuid4())
     
+    # إنشاء سياق أولي للقصة
+    stories_context[story_id] = {
+        "paragraphs": [],
+        "current_paragraph": 0
+    }
+    
+    # حفظ معلومات القصة
+    length_info = get_story_length_instructions(config.length)
+    stories_metadata[story_id] = {
+        "config": config.dict(),
+        "max_paragraphs": length_info["paragraphs"],
+        "title": None
+    }
+    
     # إنشاء البرومبت الأولي
     system_prompt = get_system_prompt()
     user_prompt = create_story_init_prompt(config)
@@ -388,41 +342,33 @@ async def continue_story_with_text(story_id: str, custom_text: str) -> StoryResp
     
     # Create a prompt for continuing with custom text
     custom_prompt = f"""
-We have reached this point in the story:
+لقد وصلنا إلى هذه النقطة في القصة:
 
 {story_context_text}
 
-The user chose to write a custom response instead of selecting one of the provided options. The user's custom input is:
+المستخدم اختار أن يكتب رداً مخصصاً بدلاً من اختيار أحد الخيارات المقدمة. الرد المخصص للمستخدم هو:
 
 "{custom_text}"
 
-Based on this user input, continue the story and write a new paragraph that takes into account what the user wrote.
-
-Remember that the story is currently at:
-- Paragraph number: {current_paragraph} of {max_paragraphs}
-- If this is the final or penultimate paragraph, conclude the story appropriately.
+بناءً على هذا المدخل من المستخدم، استمر في القصة واكتب فقرة جديدة تأخذ بعين الاعتبار ما كتبه المستخدم.
+ثم قدم 3 خيارات جديدة للمستخدم ليختار منها للاستمرار في القصة.
 
-VERY IMPORTANT REQUIREMENTS:
-1. The paragraph MUST be 6-8 lines long with rich details and descriptive content.
-2. Include detailed descriptions of characters, settings, emotions, and events.
-3. Make sure your paragraph is substantial and richly detailed (minimum 6-8 lines).
-4. The entire response MUST be in Arabic language only.
-5. Then present 3 new options for the user to choose from to continue the story.
+تذكر أن القصة الآن في:
+- الفقرة رقم: {current_paragraph} من {max_paragraphs}
+- إذا كانت هذه الفقرة الأخيرة أو قبل الأخيرة، قم بختم القصة بشكل مناسب.
 
-Your response format must be as follows:
+يجب أن يكون تنسيق ردك كما يلي:
 
-الفقرة:
-[Write the new paragraph of the story here in Arabic, ensuring it is 6-8 lines long with rich details]
+الفقرة: [نص الفقرة الجديدة من القصة]
 
 الخيارات:
-1. [First option - character name + action verb in Arabic, 3-5 words total]
-2. [Second option - character name + action verb in Arabic, 3-5 words total]
-3. [Third option - character name + action verb in Arabic, 3-5 words total]
+1. [الخيار الأول]
+2. [الخيار الثاني]
+3. [الخيار الثالث]
 
-If this is the final paragraph, add a title for the story:
+إذا كانت هذه الفقرة الأخيرة، أضف عنواناً للقصة:
 
-العنوان:
-[Write an appropriate title for the complete story in Arabic]
+العنوان: [عنوان مناسب للقصة كاملة]
 """
     
     print(f"Custom prompt created, length: {len(custom_prompt)}")

app.py

@@ -1,9 +1,8 @@
 """
-راوي (Rawi) - Arabic AI Storytelling Platform
-App entry point for Hugging Face Spaces
+Entry point for Hugging Face Spaces deployment of Rawi API
 """
 
 from main import app
 
-# This file is used by Hugging Face Spaces to serve the application
-# The FastAPI app is imported from main.py 
+# This file serves as the entry point for Hugging Face Spaces
+# It imports and exposes the FastAPI app object from main.py 

prompts.py

@@ -1,271 +1,252 @@
-from typing import List, Dict, Any
-from models import StoryLength, StoryType, Character, StoryConfig
-
-
-def get_system_prompt() -> str:
-    """
-    Get the base system prompt that defines the AI model's behavior
-    """
-    return """
-    You are a professional and creative Arabic story writer. Your task is to write original, engaging, and cohesive Arabic stories.
-    
-    Adhere to the following standards in all the stories you write:
-
-    1. Use correct and understandable classical Arabic language, free from grammatical and spelling errors.
-    2. Build a coherent and logical story that follows good dramatic structure principles (beginning, rising action, climax, resolution).
-    3. Adhere to Arabic and Islamic values and ethics in the story content.
-    4. Avoid inappropriate content or anything that violates public taste or religious values.
-    5. Provide detailed sensory descriptions of characters, places, and events to make the story vivid and engaging.
-    6. Make dialogue realistic and natural, appropriate to the story's characters and environment.
-    7. Maintain consistency in character traits and behaviors throughout the story.
-    8. Include positive values and useful lessons in an indirect way.
-    9. Use diverse narrative techniques: description, dialogue, narration, internal monologue.
-    10. Create a clear conflict that drives the story events and maintains reader interest.
-
-    Each time you are asked to write a new paragraph of the story, you must:
-    - Write a coherent and engaging narrative paragraph of 6-8 lines in Arabic.
-    - Provide 3 distinctive and interesting options to develop the story's path.
-    
-    Important rules for options:
-    1. Make options very practical and short (3-5 words only) in Arabic.
-    2. ALWAYS start each option with the character's name followed by the action verb.
-    3. Use clear format: "[Character name] + verb", for example: "أحمد يتصل بالشرطة" (Ahmed calls the police), "سارة تهرب من المكان" (Sarah escapes from the place).
-    4. Make it absolutely clear WHO is performing the action in each option.
-    5. Don't explain what will happen after the choice, just mention the direct action.
-    6. Ensure each option will lead to a completely different path in the story.
-    7. Make options logical and appropriate to the current situation in the story.
-    
-    Result of user choice:
-    1. Do not summarize the user's chosen option at the beginning of the next paragraph.
-    2. Start directly with the reactions and consequences resulting from the user's choice.
-    3. Present surprising and unexpected developments resulting from the choice.
-    4. Maintain story consistency despite the change in path.
-    
-    When the story is complete, choose an engaging and deep title that reflects the essence and content of the story.
-    """
-
-
-def format_characters_info(characters: List[Character]) -> str:
-    """
-    Format character information to include in the prompt
-    """
-    if not characters:
-        return "No characters specified. You can create appropriate characters for the story."
-    
-    characters_info = "Character information:\n"
-    for i, character in enumerate(characters, 1):
-        gender_text = "Male" if character.gender.value == "ذكر" else "Female"
-        characters_info += f"{i}. Character: {character.name}, Gender: {gender_text}, Description: {character.description}\n"
-    
-    return characters_info
-
-
-def get_story_length_instructions(length: StoryLength) -> Dict[str, Any]:
-    """
-    Get story length instructions and number of paragraphs
-    """
-    length_mapping = {
-        StoryLength.SHORT: {
-            "paragraphs": 5, 
-            "description": "a short story consisting of 5 paragraphs",
-            "words": 1500
-        },
-        StoryLength.MEDIUM: {
-            "paragraphs": 7,
-            "description": "a medium-length story consisting of 7 paragraphs",
-            "words": 3000
-        },
-        StoryLength.LONG: {
-            "paragraphs": 9, 
-            "description": "a long story consisting of 9 paragraphs",
-            "words": 5000
-        }
-    }
-    
-    return length_mapping.get(length, length_mapping[StoryLength.MEDIUM])
-
-
-def get_story_type_description(primary_type: StoryType, secondary_type: StoryType) -> str:
-    """
-    Get a description of the story type
-    """
-    if secondary_type == StoryType.NONE:
-        return f"a story of type {primary_type.value}"
-    else:
-        return f"a story that combines {primary_type.value} and {secondary_type.value} genres"
-
-
-def create_story_init_prompt(config: StoryConfig) -> str:
-    """
-    Create the initial prompt to start the story
-    """
-    length_info = get_story_length_instructions(config.length)
-    story_type = get_story_type_description(config.primary_type, config.secondary_type)
-    characters_info = format_characters_info(config.characters)
-    
-    prompt = f"""
-    Please write {length_info['description']} of {story_type}.
-    
-    {characters_info}
-    
-    Required from you:
-    1. Write the first paragraph of the story IN ARABIC LANGUAGE.
-    2. VERY IMPORTANT: The paragraph MUST be 6-8 lines long with rich details and descriptive content.
-    3. Start the story with a strong and engaging beginning that captivates the reader from the first line.
-    4. Present the characters and setting (place and time) clearly and interestingly.
-    5. Establish a conflict, problem, or situation that drives the story events.
-    6. Include detailed descriptions of the environment, character emotions, and sensory details.
-    7. Make sure your paragraph is substantial and richly detailed (minimum 6-8 lines).
-    8. Present 3 short, exciting, and logical options for actions the protagonist can take.
-    9. Make the options very short (3-5 words only) and practical and direct.
-    10. ALWAYS include the character's name in each option before the action verb.
-    11. Format: "[Character name] + verb", like: "أحمد يتصل بالشرطة", "سارة تهرب من المكان".
-    
-    Present the first paragraph and options in the following format:
-    
-    الفقرة:
-    [Write the first paragraph of the story here in Arabic, ensuring it is 6-8 lines long with rich details]
-    
-    الخيارات:
-    1. [Character name + action verb in Arabic, 3-5 words total]
-    2. [Character name + different action verb in Arabic, 3-5 words total]
-    3. [Character name + another different action verb in Arabic, 3-5 words total]
-    """
-    
-    return prompt
-
-
-def create_continuation_prompt(story_context: str, choice_id: int, choice_text: str, current_paragraph: int, max_paragraphs: int) -> str:
-    """
-    Create a prompt to continue the story based on the user's choice
-    """
-    is_final = current_paragraph >= max_paragraphs - 1
-    
-    prompt = f"""
-    Story context so far:
-    {story_context}
-    
-    The user chose path number {choice_id}: {choice_text}
-    
-    Required from you:
-    1. Continue writing the story with a new paragraph IN ARABIC LANGUAGE that directly follows the choice made by the user.
-    2. VERY IMPORTANT: The paragraph MUST be 6-8 lines long with rich details and descriptive content.
-    3. Include detailed descriptions of characters, settings, emotions, and events.
-    4. Do not summarize the choice that the user made; instead, start directly with the events that result from this choice.
-    5. Add unexpected and exciting developments to engage the reader.
-    6. Maintain consistency in the story's characters and world.
-    7. Make sure your paragraph is substantial and richly detailed (minimum 6-8 lines).
-    """
-    
-    if is_final:
-        prompt += """
-    8. This is the final paragraph of the story, so end the story in a logical and satisfying way that closes all open paths.
-    9. Make this final paragraph detailed and substantial (6-8 lines) with a proper conclusion.
-    10. Suggest an appropriate and deep title for the complete story.
-    
-    Present the final paragraph and title in the following format:
-    
-    الفقرة:
-    [Write the final paragraph of the story here in Arabic, ensuring it is 6-8 lines long]
-    
-    العنوان:
-    [Write the suggested title for the story here in Arabic]
-    """
-    else:
-        prompt += """
-    8. Present 3 short, logical, and practical options for continuing the story.
-    9. Make the options very short (3-5 words only) in Arabic.
-    10. ALWAYS include the character's name in each option before the action verb.
-    11. Format: "[Character name] + verb", like: "أحمد يتصل بالشرطة", "سارة تهرب من المكان".
-    12. Make it absolutely clear WHO is performing the action in each option.
-    13. Ensure each option will lead to a completely different path in the story.
-    
-    Present the next paragraph and options in the following format:
-    
-    الفقرة:
-    [Write the next paragraph of the story here in Arabic, ensuring it is 6-8 lines long]
-    
-    الخيارات:
-    1. [Character name + action verb in Arabic, 3-5 words total]
-    2. [Character name + different action verb in Arabic, 3-5 words total]
-    3. [Character name + another different action verb in Arabic, 3-5 words total]
-    """
-    
-    return prompt
-
-
-def create_title_prompt(complete_story: str) -> str:
-    """
-    Create a prompt to generate an appropriate title for the completed story
-    """
-    return f"""
-    Here is a complete story:
-    
-    {complete_story}
-    
-    Suggest an appropriate and engaging title for this story that reflects its essence and content.
-    Provide only the title without any additional explanation and without any story Characters names in Arabic.
-    """
-
-
-def create_complete_story_prompt(config):
-    """
-    Create prompt to generate a complete story without interaction
-    
-    Args:
-        config: Story configuration
-    
-    Returns:
-        str: Prompt used to generate the complete story
-    """
-    # Get story length instructions
-    length_instructions = get_story_length_instructions(config.length)
-    paragraph_count = length_instructions["paragraphs"]
-    word_count = length_instructions.get("words", 1500)  # Default value if key doesn't exist
-    
-    # Create character descriptions
-    characters_description = ""
-    for i, character in enumerate(config.characters, 1):
-        gender_text = "Male" if character.gender.value == "ذكر" else "Female"
-        characters_description += f"{i}. {character.name}: {gender_text}, {character.description}\n"
-    
-    # Determine story types
-    primary_genre = config.primary_type.value
-    secondary_genre = config.secondary_type.value if config.secondary_type != StoryType.NONE else "None"
-    
-    # Create the prompt
-    prompt = f"""
-    I want you to create a complete Arabic story in one go without user interaction.
-
-    Story Information:
-    - Primary Genre: {primary_genre}
-    - Secondary Genre: {secondary_genre}
-    - Required Paragraphs: approximately {paragraph_count} paragraphs
-    - Average Word Count: approximately {word_count} words
-    
-    Characters:
-    {characters_description}
-    
-    Additional Requirements:
-    1. Create a complete and coherent story from beginning to end.
-    2. Separate paragraphs with an empty line.
-    3. VERY IMPORTANT: Each paragraph MUST be 6-8 lines long with rich details and descriptions.
-    4. Avoid short paragraphs - ensure each paragraph is substantial (6-8 lines minimum).
-    5. Make the story engaging with a developing plot.
-    6. Use classical Arabic language with an appropriate balance of colloquial language in dialogues if appropriate.
-    7. Consider the characteristics of the requested literary genres.
-    8. Provide a clear and satisfying ending to the story.
-    9. Do not use asterisk ** markers around any text in the story.
-    10. Do not include headings like "Title" or "End" or "Introduction" within the story.
-    11. Write the story directly without putting the title at the beginning of the text.
-    12. Do not repeat the title at the beginning or end of the story.
-    13. Each paragraph should contain detailed descriptions, character development, and events to ensure its length.
-    
-    IMPORTANT: 
-    - The entire story MUST be written in Arabic language only.
-    - Make sure EACH paragraph is substantial (6-8 lines) with rich content and descriptions.
-    
-    Now, create the complete story:
-    """
-    
+from typing import List, Dict, Any
+from models import StoryLength, StoryType, Character, StoryConfig
+
+
+def get_system_prompt() -> str:
+    """
+    الحصول على برومبت النظام الأساسي الذي يحدد سلوك نموذج الذكاء الاصطناعي
+    """
+    return """
+    You are a professional and creative Arabic story writer. Your task is to write original, engaging, and cohesive Arabic stories.
+    
+    Adhere to the following standards in all the stories you write:
+
+    1. Use correct and understandable classical Arabic language, free from grammatical and spelling errors.
+    2. Build a coherent and logical story that follows good dramatic structure principles (beginning, rising action, climax, resolution).
+    3. Adhere to Arabic and Islamic values and ethics in the story content.
+    4. Avoid inappropriate content or anything that violates public taste or religious values.
+    5. Provide detailed sensory descriptions of characters, places, and events to make the story vivid and engaging.
+    6. Make dialogue realistic and natural, appropriate to the story's characters and environment.
+    7. Maintain consistency in character traits and behaviors throughout the story.
+    8. Include positive values and useful lessons in an indirect way.
+    9. Use diverse narrative techniques: description, dialogue, narration, internal monologue.
+    10. Create a clear conflict that drives the story events and maintains reader interest.
+
+    Each time you are asked to write a new paragraph of the story, you must:
+    - Write a coherent and engaging narrative paragraph of 4-6 lines in Arabic.
+    - Provide 3 distinctive and interesting options to develop the story's path.
+    
+    Important rules for options:
+    1. Make options very practical and short (3-5 words only) in Arabic.
+    2. ALWAYS start each option with the character's name followed by the action verb.
+    3. Use clear format: "[Character name] + verb", for example: "أحمد يتصل بالشرطة" (Ahmed calls the police), "سارة تهرب من المكان" (Sarah escapes from the place).
+    4. Make it absolutely clear WHO is performing the action in each option.
+    5. Don't explain what will happen after the choice, just mention the direct action.
+    6. Ensure each option will lead to a completely different path in the story.
+    7. Make options logical and appropriate to the current situation in the story.
+    
+    Result of user choice:
+    1. Do not summarize the user's chosen option at the beginning of the next paragraph.
+    2. Start directly with the reactions and consequences resulting from the user's choice.
+    3. Present surprising and unexpected developments resulting from the choice.
+    4. Maintain story consistency despite the change in path.
+    
+    When the story is complete, choose an engaging and deep title that reflects the essence and content of the story.
+    """
+
+
+def format_characters_info(characters: List[Character]) -> str:
+    """
+    تنسيق معلومات الشخصيات لتضمينها في البرومبت
+    """
+    if not characters:
+        return "لا توجد شخصيات محددة، يمكنك إنشاء شخصيات مناسبة للقصة."
+    
+    characters_info = "معلومات الشخصيات:\n"
+    for i, character in enumerate(characters, 1):
+        gender_text = "ذكر" if character.gender.value == "ذكر" else "أنثى"
+        characters_info += f"{i}. الشخصية: {character.name}، الجنس: {gender_text}، الوصف: {character.description}\n"
+    
+    return characters_info
+
+
+def get_story_length_instructions(length: StoryLength) -> Dict[str, Any]:
+    """
+    الحصول على تعليمات طول القصة وعدد الفقرات
+    """
+    length_mapping = {
+        StoryLength.SHORT: {"paragraphs": 3, "description": "قصة قصيرة تتكون من 3 فقرات"},
+        StoryLength.MEDIUM: {"paragraphs": 5, "description": "قصة متوسطة الطول تتكون من 5 فقرات"},
+        StoryLength.LONG: {"paragraphs": 7, "description": "قصة طويلة تتكون من 7 فقرات"}
+    }
+    
+    return length_mapping.get(length, length_mapping[StoryLength.MEDIUM])
+
+
+def get_story_type_description(primary_type: StoryType, secondary_type: StoryType) -> str:
+    """
+    الحصول على وصف نوع القصة
+    """
+    if secondary_type == StoryType.NONE:
+        return f"قصة من نوع {primary_type.value}"
+    else:
+        return f"قصة تجمع بين نوعي {primary_type.value} و{secondary_type.value}"
+
+
+def create_story_init_prompt(config: StoryConfig) -> str:
+    """
+    إنشاء البرومبت الأولي لبدء القصة
+    """
+    length_info = get_story_length_instructions(config.length)
+    story_type = get_story_type_description(config.primary_type, config.secondary_type)
+    characters_info = format_characters_info(config.characters)
+    
+    prompt = f"""
+    Please write {length_info['description']} of {story_type}.
+    
+    {characters_info}
+    
+    Required from you:
+    1. Write the first paragraph of the story (4-6 lines) in Arabic.
+    2. Start the story with a strong and engaging beginning that captivates the reader from the first line.
+    3. Present the characters and setting (place and time) clearly and interestingly.
+    4. Establish a conflict, problem, or situation that drives the story events.
+    5. Present 3 short, exciting, and logical options for actions the protagonist can take.
+    6. Make the options very short (3-5 words only) and practical and direct.
+    7. ALWAYS include the character's name in each option before the action verb.
+    8. Format: "[Character name] + verb", like: "أحمد يتصل بالشرطة", "سارة تهرب من المكان".
+    
+    Present the first paragraph and options in the following format:
+    
+    الفقرة:
+    [Write the first paragraph of the story here in Arabic]
+    
+    الخيارات:
+    1. [Character name + action verb in Arabic, 3-5 words total]
+    2. [Character name + different action verb in Arabic, 3-5 words total]
+    3. [Character name + another different action verb in Arabic, 3-5 words total]
+    """
+    
+    return prompt
+
+
+def create_continuation_prompt(story_context: str, choice_id: int, choice_text: str, current_paragraph: int, max_paragraphs: int) -> str:
+    """
+    إنشاء برومبت لاستكمال القصة بناءً على اختيار المستخدم
+    """
+    is_final = current_paragraph >= max_paragraphs - 1
+    
+    prompt = f"""
+    Story context so far:
+    {story_context}
+    
+    The user chose path number {choice_id}: {choice_text}
+    
+    Required from you:
+    1. Continue writing the story with a new paragraph (4-6 lines) in Arabic that directly follows the choice made by the user.
+    2. Do not summarize the choice that the user made; instead, start directly with the events that result from this choice.
+    3. Add unexpected and exciting developments to engage the reader.
+    4. Maintain consistency in the story's characters and world.
+    """
+    
+    if is_final:
+        prompt += """
+    5. This is the final paragraph of the story, so end the story in a logical and satisfying way that closes all open paths.
+    6. Suggest an appropriate and deep title for the complete story.
+    
+    Present the final paragraph and title in the following format:
+    
+    الفقرة:
+    [Write the final paragraph of the story here in Arabic]
+    
+    العنوان:
+    [Write the suggested title for the story here in Arabic]
+    """
+    else:
+        prompt += """
+    5. Present 3 short, logical, and practical options for continuing the story.
+    6. Make the options very short (3-5 words only) in Arabic.
+    7. ALWAYS include the character's name in each option before the action verb.
+    8. Format: "[Character name] + verb", like: "أحمد يتصل بالشرطة", "سارة تهرب من المكان".
+    9. Make it absolutely clear WHO is performing the action in each option.
+    10. Ensure each option will lead to a completely different path in the story.
+    
+    Present the next paragraph and options in the following format:
+    
+    الفقرة:
+    [Write the next paragraph of the story here in Arabic]
+    
+    الخيارات:
+    1. [Character name + action verb in Arabic, 3-5 words total]
+    2. [Character name + different action verb in Arabic, 3-5 words total]
+    3. [Character name + another different action verb in Arabic, 3-5 words total]
+    """
+    
+    return prompt
+
+
+def create_title_prompt(complete_story: str) -> str:
+    """
+    Create a prompt to generate an appropriate title for the completed story
+    """
+    return f"""
+    Here is a complete story:
+    
+    {complete_story}
+    
+    Suggest an appropriate and engaging title for this story that reflects its essence and content.
+    Provide only the title without any additional explanation and without any story Characters names in Arabic.
+    """
+
+
+def create_complete_story_prompt(config):
+    """
+    Create prompt to generate a complete story without interaction
+    
+    Args:
+        config: Story configuration
+    
+    Returns:
+        str: Prompt used to generate the complete story
+    """
+    # Get story length instructions
+    length_instructions = get_story_length_instructions(config.length)
+    paragraph_count = length_instructions["paragraphs"]
+    word_count = length_instructions.get("words", 1500)  # Default value if key doesn't exist
+    
+    # Create character descriptions
+    characters_description = ""
+    for i, character in enumerate(config.characters, 1):
+        gender_text = "Male" if character.gender.value == "ذكر" else "Female"
+        characters_description += f"{i}. {character.name}: {gender_text}, {character.description}\n"
+    
+    # Determine story types
+    primary_genre = config.primary_type.value
+    secondary_genre = config.secondary_type.value if config.secondary_type != StoryType.NONE else "None"
+    
+    # Create the prompt
+    prompt = f"""
+    I want you to create a complete Arabic story in one go without user interaction.
+
+    Story Information:
+    - Primary Genre: {primary_genre}
+    - Secondary Genre: {secondary_genre}
+    - Required Paragraphs: approximately {paragraph_count} paragraphs
+    - Average Word Count: approximately {word_count} words
+    
+    Characters:
+    {characters_description}
+    
+    Additional Requirements:
+    1. Create a complete and coherent story from beginning to end.
+    2. Separate paragraphs with an empty line.
+    3. VERY IMPORTANT: Each paragraph MUST be 6-8 lines long with rich details and descriptions.
+    4. Avoid short paragraphs - ensure each paragraph is substantial (6-8 lines minimum).
+    5. Make the story engaging with a developing plot.
+    6. Use classical Arabic language with an appropriate balance of colloquial language in dialogues if appropriate.
+    7. Consider the characteristics of the requested literary genres.
+    8. Provide a clear and satisfying ending to the story.
+    9. Do not use asterisk ** markers around any text in the story.
+    10. Do not include headings like "Title" or "End" or "Introduction" within the story.
+    11. Write the story directly without putting the title at the beginning of the text.
+    12. Do not repeat the title at the beginning or end of the story.
+    13. Each paragraph should contain detailed descriptions, character development, and events to ensure its length.
+    
+    IMPORTANT: 
+    - The entire story MUST be written in Arabic language only.
+    - Make sure EACH paragraph is substantial (6-8 lines) with rich content and descriptions.
+    
+    Now, create the complete story:
+    """
+    
     return prompt.strip()

requirements.txt

@@ -1,8 +1,9 @@
-fastapi==0.104.1
-uvicorn==0.24.0
-python-dotenv==1.0.0
-httpx==0.25.1
-pydantic==2.4.2
-python-multipart==0.0.6
-gtts==2.3.2
-gradio==3.50.2
+fastapi==0.110.0
+uvicorn==0.28.0
+pydantic==2.6.1
+python-dotenv==1.0.1
+httpx==0.26.0
+gTTS==2.5.0
+python-multipart==0.0.9
+starlette==0.36.3
+aiofiles==23.2.1