README.md

metadata

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: הרצה מהירה

python run_local.py

אפשרות 2: הרצה ידנית

# התקנת 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
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 - שפר את הממשק או הפונקציונליות

📄 רישיון

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

---

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