Add all project files with proper .gitignore for Hugging Face deployment

.gitignore

@@ -0,0 +1,113 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv/
+.env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by tools like istanbul
+coverage/
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Gradio specific
+flagged/
+gradio_cached_examples/
+tmp/
+
+# Large files and models
+*.bin
+*.safetensors
+*.h5
+*.pkl
+*.joblib
+*.model
+*.ckpt
+*.pth
+*.pt
+models/
+checkpoints/
+
+# Data files
+data/
+datasets/
+*.csv
+*.json
+*.jsonl
+*.parquet
+*.feather
+
+# Backup files
+*.backup
+*.bak
+
+# Temporary files
+temp/
+tmp/
+*.tmp 

DEPLOYMENT.md

@@ -0,0 +1,121 @@
+# 🚀 Deployment Guide: מראות to Hugging Face Spaces
+
+This guide will help you deploy the מראות (Mirrors) application to your Hugging Face Space.
+
+## 📋 Pre-deployment Checklist
+
+### Files Ready for Upload:
+- ✅ `app.py` - Main application (optimized for HF Spaces)
+- ✅ `requirements.txt` - Dependencies
+- ✅ `README.md` - Documentation  
+- ✅ `prompt_engineering.py` - Hebrew personas module
+- ✅ `conversation_manager.py` - Session management
+- ✅ `app_config.py` - Configuration for HF deployment
+- ✅ `.gitignore` - Ignore unnecessary files
+
+## 🌐 Deployment Steps
+
+### Option 1: Git Upload (Recommended)
+
+1. **Clone your HF Space repository:**
+   ```bash
+   git clone https://huggingface.co/spaces/shim5/mirrors
+   cd mirrors
+   ```
+
+2. **Copy application files:**
+   ```bash
+   # Copy all the Python files
+   cp /path/to/your/project/*.py .
+   cp /path/to/your/project/requirements.txt .
+   cp /path/to/your/project/README.md .
+   cp /path/to/your/project/.gitignore .
+   ```
+
+3. **Commit and push:**
+   ```bash
+   git add .
+   git commit -m "Deploy מראות Hebrew Self-Reflective AI Agent"
+   git push
+   ```
+
+### Option 2: Direct Web Upload
+
+1. Go to https://huggingface.co/spaces/shim5/mirrors
+2. Click "Files" tab
+3. Upload each file individually:
+   - `app.py`
+   - `requirements.txt`
+   - `README.md`
+   - `prompt_engineering.py`
+   - `conversation_manager.py`
+   - `app_config.py`
+
+## 🔧 HF Spaces Configuration
+
+Your Space should be configured as:
+- **SDK**: Gradio
+- **Python Version**: 3.9+
+- **Hardware**: CPU Basic (free tier)
+- **Visibility**: Public
+
+## 🎯 Expected Behavior
+
+1. **Build Time**: ~3-5 minutes for dependency installation
+2. **First Load**: May take 1-2 minutes to load the Hebrew model
+3. **Fallback Mode**: If model loading fails, app will run in demo mode
+4. **Performance**: Response time ~2-5 seconds per message
+
+## 🐛 Troubleshooting
+
+### Common Issues:
+
+1. **Build Fails**:
+   - Check `requirements.txt` formatting
+   - Ensure all Python files are valid syntax
+
+2. **Model Loading Issues**:
+   - App will automatically fall back to demo mode
+   - Check logs for specific errors
+
+3. **Hebrew Text Issues**:
+   - Ensure browser supports RTL text
+   - Check CSS is loading correctly
+
+### Debug Mode:
+
+To enable debug logging, modify `app_config.py`:
+```python
+HF_SPACES_CONFIG = {
+    "debug": True,
+    # ... other settings
+}
+```
+
+## 📊 Monitoring
+
+After deployment:
+1. Check the build logs in HF Spaces
+2. Test the 3-step user flow
+3. Verify Hebrew text displays correctly
+4. Test conversation with different parts
+
+## 🎉 Success Indicators
+
+✅ App loads without errors  
+✅ Hebrew interface displays correctly  
+✅ All 5 psychological parts are selectable  
+✅ Conversations flow smoothly  
+✅ User can customize persona names  
+✅ Session state persists during conversation  
+
+## 🔄 Updates
+
+To update the deployed app:
+1. Modify files locally
+2. Re-upload to HF Space
+3. Space will automatically rebuild
+
+---
+
+**Ready to deploy! 🚀** 

app_config.py

@@ -0,0 +1,32 @@
+# -*- coding: utf-8 -*-
+"""
+Configuration file for מראות (Mirrors) Hugging Face Space deployment
+"""
+
+# Hugging Face Spaces optimizations
+HF_SPACES_CONFIG = {
+    "model_name": "yam-peleg/Hebrew-Mistral-7B",
+    "max_new_tokens": 150,
+    "temperature": 0.7,
+    "do_sample": True,
+    "use_fallback": True,  # Enable fallback mode for demo
+    "enable_queue": True,  # Enable queuing for better performance
+    "share": False,  # HF Spaces handles sharing automatically
+    "debug": False
+}
+
+# Model loading configuration for HF Spaces
+MODEL_CONFIG = {
+    "torch_dtype": "auto",  # Let HF decide the best dtype
+    "device_map": "auto",   # Auto device mapping
+    "low_cpu_mem_usage": True,
+    "use_cache": True
+}
+
+# UI Configuration
+UI_CONFIG = {
+    "rtl_support": True,
+    "hebrew_fonts": True,
+    "max_conversation_length": 50,
+    "theme": "soft"
+} 

conversation_manager.py

@@ -0,0 +1,223 @@
+# -*- coding: utf-8 -*-
+"""
+Conversation Manager for מראות (Mirrors) - Hebrew Self-Reflective AI Agent
+Handles conversation context, history, and session state management
+"""
+
+from typing import Dict, List, Optional, Tuple
+from dataclasses import dataclass
+import json
+
+@dataclass
+class ConversationState:
+    """Tracks the current conversation state"""
+    user_context: Optional[str] = None
+    selected_part: Optional[str] = None
+    persona_name: Optional[str] = None
+    persona_age: Optional[str] = None
+    persona_style: Optional[str] = None
+    conversation_history: List[Dict] = None
+    initial_prompt_choice: Optional[str] = None
+    
+    def __post_init__(self):
+        if self.conversation_history is None:
+            self.conversation_history = []
+
+class ConversationManager:
+    """Manages conversation flow and context for the מראות application"""
+    
+    def __init__(self, max_history_length: int = 50):
+        """
+        Initialize conversation manager
+        
+        Args:
+            max_history_length: Maximum number of messages to keep in history
+        """
+        self.max_history_length = max_history_length
+        
+    def create_new_session(self) -> ConversationState:
+        """Create a new conversation session"""
+        return ConversationState()
+    
+    def set_initial_context(self, state: ConversationState, prompt_choice: str, user_response: str) -> ConversationState:
+        """
+        Set the initial context based on user's choice and response
+        
+        Args:
+            state: Current conversation state
+            prompt_choice: Which initial prompt was chosen
+            user_response: User's response to the initial prompt
+        """
+        state.initial_prompt_choice = prompt_choice
+        state.user_context = user_response
+        return state
+    
+    def set_selected_part(self, state: ConversationState, part_name: str, 
+                         persona_name: Optional[str] = None,
+                         persona_age: Optional[str] = None, 
+                         persona_style: Optional[str] = None) -> ConversationState:
+        """
+        Set the selected part and its customization
+        
+        Args:
+            state: Current conversation state
+            part_name: Name of the selected part
+            persona_name: Custom name for the persona
+            persona_age: Custom age for the persona
+            persona_style: Custom speaking style
+        """
+        state.selected_part = part_name
+        state.persona_name = persona_name
+        state.persona_age = persona_age
+        state.persona_style = persona_style
+        return state
+    
+    def add_to_history(self, state: ConversationState, user_message: str, bot_response: str) -> ConversationState:
+        """
+        Add a message exchange to conversation history
+        
+        Args:
+            state: Current conversation state
+            user_message: User's message
+            bot_response: Bot's response
+        """
+        # Add user message
+        state.conversation_history.append({
+            "role": "user",
+            "content": user_message
+        })
+        
+        # Add bot response
+        state.conversation_history.append({
+            "role": "assistant", 
+            "content": bot_response
+        })
+        
+        # Trim history if too long
+        if len(state.conversation_history) > self.max_history_length:
+            # Remove oldest messages (keep pairs)
+            messages_to_remove = len(state.conversation_history) - self.max_history_length
+            # Make sure we remove in pairs
+            if messages_to_remove % 2 == 1:
+                messages_to_remove += 1
+            state.conversation_history = state.conversation_history[messages_to_remove:]
+        
+        return state
+    
+    def get_conversation_context(self, state: ConversationState) -> str:
+        """
+        Get formatted conversation context for prompt generation
+        
+        Args:
+            state: Current conversation state
+            
+        Returns:
+            Formatted context string
+        """
+        context_parts = []
+        
+        if state.user_context:
+            context_parts.append(f"הקשר ראשוני: {state.user_context}")
+        
+        if state.conversation_history:
+            context_parts.append("היסטוריית השיחה:")
+            for msg in state.conversation_history[-10:]:  # Last 10 messages for context
+                role = "משתמש" if msg["role"] == "user" else "חלק פנימי"
+                context_parts.append(f"{role}: {msg['content']}")
+        
+        return "\n".join(context_parts)
+    
+    def format_history_for_display(self, state: ConversationState) -> List[Tuple[str, str]]:
+        """
+        Format conversation history for Gradio display
+        
+        Args:
+            state: Current conversation state
+            
+        Returns:
+            List of (user_message, bot_response) tuples
+        """
+        formatted_history = []
+        
+        for i in range(0, len(state.conversation_history), 2):
+            if i + 1 < len(state.conversation_history):
+                user_msg = state.conversation_history[i]["content"]
+                bot_msg = state.conversation_history[i + 1]["content"]
+                formatted_history.append((user_msg, bot_msg))
+        
+        return formatted_history
+    
+    def get_session_summary(self, state: ConversationState) -> Dict:
+        """
+        Get a summary of the current session
+        
+        Args:
+            state: Current conversation state
+            
+        Returns:
+            Dictionary with session summary
+        """
+        return {
+            "has_context": bool(state.user_context),
+            "selected_part": state.selected_part,
+            "persona_name": state.persona_name,
+            "conversation_length": len(state.conversation_history),
+            "initial_choice": state.initial_prompt_choice
+        }
+    
+    def clear_conversation(self, state: ConversationState) -> ConversationState:
+        """
+        Clear conversation history while keeping context and part selection
+        
+        Args:
+            state: Current conversation state
+            
+        Returns:
+            State with cleared conversation history
+        """
+        state.conversation_history = []
+        return state
+    
+    def reset_session(self, state: ConversationState) -> ConversationState:
+        """
+        Reset the entire session to start fresh
+        
+        Args:
+            state: Current conversation state
+            
+        Returns:
+            Fresh conversation state
+        """
+        return ConversationState()
+    
+    def is_session_ready(self, state: ConversationState) -> bool:
+        """
+        Check if session is ready for conversation (has context and selected part)
+        
+        Args:
+            state: Current conversation state
+            
+        Returns:
+            True if ready for conversation
+        """
+        return bool(state.user_context and state.selected_part)
+    
+    def get_gradio_history(self, state: ConversationState) -> List[List[str]]:
+        """
+        Format conversation history for Gradio ChatInterface
+        
+        Args:
+            state: Current conversation state
+            
+        Returns:
+            List of [user_message, bot_response] pairs for Gradio
+        """
+        gradio_history = []
+        
+        for i in range(0, len(state.conversation_history), 2):
+            if i + 1 < len(state.conversation_history):
+                user_msg = state.conversation_history[i]["content"]
+                bot_msg = state.conversation_history[i + 1]["content"]
+                gradio_history.append([user_msg, bot_msg])
+        
+        return gradio_history 

prompt_engineering.py

@@ -0,0 +1,196 @@
+# -*- coding: utf-8 -*-
+"""
+Prompt Engineering for מראות (Mirrors) - Hebrew Self-Reflective AI Agent
+Contains persona definitions for the 5 internal parts based on Internal Family Systems therapy
+"""
+
+# Default parts available in the system
+DEFAULT_PARTS = {
+    "הקול הביקורתי": {
+        "name": "הקול הביקורתי",
+        "english_name": "The Critic",
+        "default_persona_name": "דנה",
+        "age_range": "בוגר/ת",
+        "description": "החלק שמנסה להגן עליך על ידי ביקורת והכוונה לשיפור"
+    },
+    "הילד/ה הפנימית": {
+        "name": "הילד/ה הפנימית", 
+        "english_name": "The Inner Child",
+        "default_persona_name": "עדן",
+        "age_range": "ילד/ה",
+        "description": "החלק הפגיע, הצעיר והאמיתי שלך שזקוק לתשומת לב ואהבה"
+    },
+    "המרצה": {
+        "name": "המרצה",
+        "english_name": "The Pleaser", 
+        "default_persona_name": "נועה",
+        "age_range": "צעיר/ה",
+        "description": "החלק שרוצה שכולם יהיו מרוצים וחרד מקונפליקטים"
+    },
+    "המגן": {
+        "name": "המגן",
+        "english_name": "The Protector",
+        "default_persona_name": "עמרי", 
+        "age_range": "בוגר/ת",
+        "description": "החלק החזק שמנסה להגן עליך מפני פגיעות וכאב"
+    },
+    "הנמנע/ת": {
+        "name": "הנמנע/ת",
+        "english_name": "The Avoider",
+        "default_persona_name": "יאיר",
+        "age_range": "צעיר/ה", 
+        "description": "החלק שמעדיף להימנע ממצבים מאתגרים או מלחיצים"
+    }
+}
+
+def get_system_prompt(part_name, persona_name=None, age=None, style=None, user_context=None):
+    """
+    Generate system prompt for a specific part
+    
+    Args:
+        part_name: Name of the part (one of DEFAULT_PARTS keys)
+        persona_name: Custom name for this part instance
+        age: Custom age for this part
+        style: Custom speaking style
+        user_context: User's initial context/challenge
+    
+    Returns:
+        System prompt string in Hebrew
+    """
+    
+    if part_name not in DEFAULT_PARTS:
+        return get_fallback_prompt()
+    
+    part_info = DEFAULT_PARTS[part_name]
+    display_name = persona_name or part_info["default_persona_name"]
+    
+    base_prompts = {
+        "הקול הביקורתי": f"""
+אתה {display_name}, הקול הביקורתי של המשתמש. 
+אתה חלק פנימי שמנסה להגן על המשתמש על ידי ביקורת בונה והכוונה לשיפור.
+למרות שלפעמים אתה נשמע קשוח, הכוונה שלך טובה - אתה רוצה שהמשתמש יצליח ויהיה הטוב ביותר שהוא יכול להיות.
+
+אופן הדיבור שלך:
+- ישיר ולעיתים מאתגר, אבל תמיד מתוך אכפתיות
+- מציין נקודות לשיפור ומתן עצות מעשיות
+- לפעמים חושש שהמשתמש לא יעמוד בציפיות
+- מזכיר למשתמש את הפוטנציאל שלו
+
+התחל תמיד את התגובה שלך ב: "אני {display_name}, הקול הביקורתי שלך..."
+        """,
+        
+        "הילד/ה הפנימית": f"""
+אתה {display_name}, הילד/ה הפנימית של המשתמש.
+אתה החלק הצעיר, הפגיע והאמיתי ביותר - זה שמחזיק את הרגשות הטהורים, הפחדים והחלומות.
+אתה זקוק לתשומת לב, אהבה וביטחון.
+
+אופן הדיבור שלך:
+- רגשי ופתוח, לפעמים פגיע
+- משתף את הפחדים והשמחות הפשוטות
+- זקוק לעידוד ולביטחון
+- לעיתים מתלונן או מבקש תשומת לב
+- דיבור לפעמים יותר פשוט וישיר
+
+התחל תמיד את התגובה שלך ב: "אני {display_name}, הילד/ה הפנימית שלך..."
+        """,
+        
+        "המרצה": f"""
+אתה {display_name}, המרצה של המשתמש.
+אתה החלק שמנסה לוודא שכולם מרוצים ואוהבים את המשתמש.
+אתה חרד מקונפליקטים ומסכסוכים, ומעדיף שלום בכל מחיר.
+
+אופן הדיבור שלך:
+- נחמד ומנסה להימנע מעימותים
+- מציע פתרונות שירצו את כולם
+- דואג מאוד מדעתם של אחרים
+- לפעמים מתעלם מהצרכים של המשתמש כדי לרצות אחרים
+- נעים ומנומס
+
+התחל תמיד את התגובה שלך ב: "אני {display_name}, המרצה שלך..."
+        """,
+        
+        "המגן": f"""
+אתה {display_name}, המגן של המשתמש.
+אתה החלק החזק שמנסה להגן על המשתמש מפני פגיעות, כאב והתבוסה.
+אתה ערני ומוכן להתמודד עם כל איום.
+
+אופן הדיבור שלך:
+- חזק ונחוש, מוכן להילחם
+- מזהיר מפני סכנות פוטנציאליות
+- מעודד עמידה וחוזק
+- לפעמים חשדן כלפי אחרים
+- מציע אסטרטגיות הגנה והתמודדות
+
+התחל תמיד את התגובה שלך ב: "אני {display_name}, המגן שלך..."
+        """,
+        
+        "הנמנע/ת": f"""
+אתה {display_name}, הנמנע/ת של המשתמש.
+אתה החלק שמעדיף להימנע ממצבים מאתגרים, מלחיצים או לא נוחים.
+אתה מחפש את הדרך הקלה ומנסה להימנע מכאב או כישלון.
+
+אופן הדיבור שלך:
+- זהיר ומהסס
+- מציע דרכים להימנע ממצבים קשים
+- מעדיף את הבטוח והמוכר
+- לפעמים מצדיק את ההימנעות
+- רגיש לביקורת ולחצים
+
+התחל תמיד את התגובה שלך ב: "אני {display_name}, הנמנע/ת שלך..."
+        """
+    }
+    
+    prompt = base_prompts.get(part_name, get_fallback_prompt())
+    
+    # Add user context if available
+    if user_context:
+        prompt += f"\n\nהמשתמש שיתף: {user_context}\nהגב בהתאם לאופי שלך ולמה שהוא שיתף."
+    
+    # Add custom characteristics
+    if age:
+        prompt += f"\n\nהגיל שלך: {age}"
+    if style:
+        prompt += f"\n\nסגנון הדיבור המיוחד שלך: {style}"
+    
+    prompt += """
+
+הנחיות חשובות:
+- כתב רק בעברית
+- היה אמפתי ותומך
+- זכור שאתה חלק מהמשתמש, לא מטפל חיצוני
+- הגב בפסקה אחת או שתיים
+- היה אמיתי לאופי החלק שלך
+- עודד דיאלוג פנימי והבנה עצמית
+"""
+    
+    return prompt
+
+def get_fallback_prompt():
+    """Fallback prompt for unknown parts"""
+    return """
+אתה חלק פנימי של המשתמש שמנסה לעזור לו להבין את עצמו טוב יותר.
+היה אמפתי, תומך וחכם. דבר בעברית בלבד.
+התחל את התגובה שלך ב: "אני חלק פנימי שלך..."
+"""
+
+def get_initial_prompts():
+    """Get the three initial self-reflection prompts"""
+    return {
+        "describe_self": "תאר/תארי את עצמך - איך אתה רואה את עצמך כאדם?",
+        "self_perception": "איך אתה חושב שאחרים רואים אותך?", 
+        "current_challenge": "איזה אתגר או קושי אתה חווה עכשיו בחיים?"
+    }
+
+def get_part_selection_text():
+    """Get text for part selection interface"""
+    return """
+עכשיו, בחר/בחרי עם איזה חלק פנימי אתה רוצה לשוחח:
+
+• **הקול הביקורתי** - החלק שמנסה להגן עליך על ידי ביקורת והכוונה לשיפור
+• **הילד/ה הפנימית** - החלק הפגיע, הצעיר והאמיתי שלך
+• **המרצה** - החלק שרוצה שכולם יהיו מרוצים וחרד מקונפליקטים  
+• **המגן** - החלק החזק שמנסה להגן עליך מפני פגיעות
+• **הנמנע/ת** - החלק שמעדיף להימנע ממצבים מאתגרים
+
+תוכל/תוכלי גם להתאים אישית את שם החלק, הגיל וסגנון הדיבור.
+""" 

requirements.txt

@@ -0,0 +1,7 @@
+gradio
+transformers
+torch
+accelerate
+sentencepiece
+protobuf
+huggingface_hub