README.md

---
title: Mirrors
emoji: 🏆
colorFrom: yellow
colorTo: blue
sdk: gradio
sdk_version: 5.33.2
app_file: app.py
pinned: false
---

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

# 🪞 מראות (Mirrors) - Hebrew Self-Reflective AI Agent

מרחב אישי בטוח לשיח פנימי עם החלקים השונים של עצמך, מבוסס על תיאוריית מערכת המשפחה הפנימית (IFS).

## ✨ מה זה מראות?

מראות היא אפליקציה ליצירת דיאלוג פנימי עם 5 חלקים פסיכולוגיים מרכזיים:

- **הקול הביקורתי** - החלק שמנסה להגן עליך על ידי ביקורת והכוונה
- **הילד/ה הפנימית** - החלק הפגיע, הצעיר והאמיתי שלך  
- **המרצה** - החלק שרוצה שכולם יהיו מרוצים
- **המגן** - החלק החזק שמגן עליך מפני פגיעות
- **הנמנע/ת** - החלק שמעדיף להימנע ממצבים מאתגרים

## 🚀 הרצה מקומית

### אפשרות 1: הרצה מהירה
```bash
python run_local.py
```

### אפשרות 2: הרצה ידנית
```bash
# התקנת dependencies
pip install -r requirements.txt

# הרצת האפליקציה הראשית
python app.py

# או הרצת הגרסה הפשוטה
python simple_app.py
```

### בעיות נפוצות
- אם יש בעיה עם המודל, האפליקציה תעבור אוטומטית למצב תגובות תבניתי
- אם האפליקציה הראשית לא עובדת, נסה: `python simple_app.py`
- וודא שאתה ב-virtual environment אם יש בעיות dependencies

## 🌐 פריסה ל-Hugging Face Spaces

### שלב 1: צור Space חדש
1. לך ל-[Hugging Face Spaces](https://huggingface.co/spaces)
2. צור Space חדש עם הגדרות:
   - **SDK**: Gradio
   - **Hardware**: CPU Basic (חינם)
   - **Python Version**: 3.9+

### שלב 2: העלה קבצים
העלה את הקבצים הבאים ל-Space שלך:
- `app.py`
- `requirements.txt`  
- `prompt_engineering.py`
- `conversation_manager.py`
- `README.md`

### שלב 3: הרצה אוטומטית
ה-Space יזהה שמדובר באפליקצית Gradio ויריץ את `app.py` אוטומטית.

## 🔧 מאפיינים טכניים

### מערכת תגובות חכמה
- **תגובות תבניתיות ראשוניות**: מערכת מהימנה שתמיד עובדת
- **שיפור מודל AI (אופציונלי)**: כשזמין, משפר את התגובות
- **התאמה לסביבה**: מתנהג זהה מקומית וב-HF Spaces

### תמיכה בעברית מלאה
- ממשק בעברית מותאם RTL
- תגובות אותנטיות לכל persona
- הבנת קונטקסט רגשי

### ניהול שיחה מתקדם
- זכירת הקשר ראשוני
- התאמה אישית של personas
- ניהול היסטוריית שיחה

## 📋 דרישות מערכת

```
Python 3.9+
gradio>=4.0.0
transformers>=4.30.0
torch>=2.0.0
```

## 🎯 מבנה הפרויקט

```
mirrors-app/
├── app.py                 # אפליקציה ראשית
├── simple_app.py          # גרסה פשוטה
├── run_local.py           # סקריפט הרצה מקומית
├── prompt_engineering.py  # ניהול personas ו-prompts
├── conversation_manager.py # ניהול שיחות
├── requirements.txt       # dependencies
└── README.md              # המדריך הזה
```

## 💡 שימוש באפליקציה

1. **שלב ראשון**: ספר על עצמך או על מצבך הנוכחי
2. **שלב שני**: בחר חלק פנימי לשיחה והתאם אותו
3. **שלב שלישי**: התחל שיחה פתוחה עם החלק שבחרת

## 🤝 תרומה לפרויקט

הפרויקט מעוצב להיות פשוט ומודולרי:
- `prompt_engineering.py` - הוסף personas חדשים או שפר את הקיימים
- `conversation_manager.py` - שפר ניהול שיחות
- `app.py` - שפר את הממשק או הפונקציונליות

## 📄 רישיון

פרויקט קוד פתוח למטרות חינוכיות ופיתוח אישי.

---

🪞 **מראות - מקום בטוח לשוחח עם עצמך** 🪞