Add project files

README.md

@@ -0,0 +1,142 @@
+# English:
+
+# Smart Dream Interpreter (Morphius) 🔮
+
+[![Hugging Face Spaces](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME)
+
+A simple and creative web application for dream interpretation and analysis using the power of artificial intelligence. The project allows users to enter their dream text and receive a poetic and psychological interpretation based on symbols.
+
+![Screenshot of the application interface](https://example.com/screenshot.png) ## ✨ Features
+
+* **Simple and beautiful user interface:** Built with `Gradio` for a smooth user experience.
+* **Powerful AI engine:** Using the advanced `google/gemma-2-27b-it` model via the free OpenRouter API.
+* **Personalized:** The AI ​​model appears as an ancient and wise dream interpreter named "Morpheus".
+* **Ready to deploy:** Easily and for free to deploy in Hugging Face Spaces.
+
+## 🛠️ Technologies Used
+
+* **User Interface:** [Gradio](https://www.gradio.app/)
+* **AI Model:** [Google Gemma 2 27B IT](https://openrouter.ai/models/google/gemma-2-27b-it)
+* **API Provider:** [OpenRouter](https://openrouter.ai/)
+* **Deployment Platform:** [Hugging Face Spaces](https://huggingface.co/spaces)
+
+## 🚀 Setup and Run Locally
+
+To run this project on your personal system, follow these steps:
+
+1. **Clone the repository:**
+```bash
+git clone [https://github.com/YOUR_USERNAME/dream-interpreter.git](https://github.com/YOUR_USERNAME/dream-interpreter.git)
+cd dream-interpreter
+```
+
+2. **Install Prerequisites:**
+It is recommended to use a virtual environment.
+```bash
+python -m venv venv
+source venv/bin/activate # On Windows use `venv\Scripts\activate`
+pip install -r requirements.txt
+```
+
+3. **Set up your API key:**
+* Create an account on [OpenRouter.ai](https://openrouter.ai/) and get an API key.
+* Create a file called `.env` in the root of your project and put your key in it:
+```
+OPENROUTER_API_KEY="sk-or-..."
+```
+* The `app.py` file is written to read this variable automatically.
+
+4. **Run the program:**
+```bash
+gradio app.py
+```
+Now you can view the application in your browser at `http://127.0.0.1:7860`.
+
+## ☁️ Deploying to Hugging Face Spaces
+
+This project is optimized for deployment to Spaces:
+
+1. Create a new Space of type **Gradio SDK** in Hugging Face.
+2. Upload the `app.py` and `requirements.txt` files to it.
+3. Go to **Settings > Secrets** and create a new Secret named `OPENROUTER_API_KEY` and the value of your API key.
+4. Space will automatically build and run the application.
+
+## 🤝 Contributions
+
+Any contributions, bug reports, or suggestions for improving the project are welcome. Please open an Issue or submit a Pull Request.
+
+## 📄 License
+
+This project is released under the MIT License.
+
+-------------------------------------------------------------------------
+
+# persian
+# مفسر خواب هوشمند (Morphius) 🔮
+
+[![Hugging Face Spaces](https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-Spaces-blue)](https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE_NAME)
+
+یک وب اپلیکیشن ساده و خلاقانه برای تعبیر و تحلیل خواب با استفاده از قدرت هوش مصنوعی. این پروژه به کاربران اجازه می‌دهد تا متن خواب خود را وارد کرده و تفسیری شاعرانه و روانشناسانه بر اساس نمادها دریافت کنند.
+
+![تصویری از رابط کاربری برنامه](https://example.com/screenshot.png) ## ✨ ویژگی‌ها
+
+* **رابط کاربری ساده و زیبا:** ساخته شده با `Gradio` برای تجربه کاربری روان.
+* **موتور هوش مصنوعی قدرتمند:** استفاده از مدل پیشرفته `google/gemma-2-27b-it` از طریق API رایگان OpenRouter.
+* **شخصیت‌پردازی شده:** مدل هوش مصنوعی در نقش یک مفسر خواب باستانی و خردمند به نام "مورفیوس" ظاهر می‌شود.
+* **آماده استقرار:** به راحتی و به صورت رایگان در Hugging Face Spaces قابل استقرار است.
+
+## 🛠️ تکنولوژی‌های استفاده شده
+
+* **رابط کاربری:** [Gradio](https://www.gradio.app/)
+* **مدل هوش مصنوعی:** [Google Gemma 2 27B IT](https://openrouter.ai/models/google/gemma-2-27b-it)
+* **ارائه دهنده API:** [OpenRouter](https://openrouter.ai/)
+* **پلتفرم استقرار:** [Hugging Face Spaces](https://huggingface.co/spaces)
+
+## 🚀 راه‌اندازی و اجرا به صورت محلی (Local)
+
+برای اجرای این پروژه روی سیستم شخصی خود، مراحل زیر را دنبال کنید:
+
+1.  **کلون کردن ریپازیتوری:**
+    ```bash
+    git clone [https://github.com/YOUR_USERNAME/dream-interpreter.git](https://github.com/YOUR_USERNAME/dream-interpreter.git)
+    cd dream-interpreter
+    ```
+
+2.  **نصب پیش‌نیازها:**
+    توصیه می‌شود از یک محیط مجازی (virtual environment) استفاده کنید.
+    ```bash
+    python -m venv venv
+    source venv/bin/activate  # On Windows use `venv\Scripts\activate`
+    pip install -r requirements.txt
+    ```
+
+3.  **تنظیم کلید API:**
+    * یک حساب کاربری در [OpenRouter.ai](https://openrouter.ai/) بسازید و یک کلید API دریافت کنید.
+    * یک فایل به نام `.env` در ریشه پروژه بسازید و کلید خود را در آن قرار دهید:
+        ```
+        OPENROUTER_API_KEY="sk-or-..."
+        ```
+    * فایل `app.py` طوری نوشته شده که این متغیر را به صورت خودکار بخواند.
+
+4.  **اجرای برنامه:**
+    ```bash
+    gradio app.py
+    ```
+    حالا می‌توانید برنامه را در مرورگر خود از طریق آدرس `http://127.0.0.1:7860` مشاهده کنید.
+
+## ☁️ استقرار در Hugging Face Spaces
+
+این پروژه برای استقرار در Spaces بهینه شده است:
+
+1.  یک Space جدید از نوع **Gradio SDK** در Hugging Face بسازید.
+2.  فایل‌های `app.py` و `requirements.txt` را در آن آپلود کنید.
+3.  به بخش **Settings > Secrets** بروید و یک Secret جدید با نام `OPENROUTER_API_KEY` و مقدار کلید API خود بسازید.
+4.  Space به طور خودکار برنامه را ساخته و اجرا خواهد کرد.
+
+## 🤝 مشارکت
+
+از هرگونه مشارکت، گزارش باگ یا پیشنهاد برای بهبود پروژه استقبال می‌شود. لطفاً یک Issue باز کنید یا یک Pull Request ارسال نمایید.
+
+## 📄 مجوز
+
+این پروژه تحت مجوز MIT منتشر شده است.

README.mdZone.Identifier

@@ -0,0 +1,2 @@
+[ZoneTransfer]
+ZoneId=3

app.py

@@ -0,0 +1,66 @@
+import os
+import requests
+import gradio as gr
+
+def interpret_dream(dream_text: str) -> str:
+    api_key = os.getenv('OPENROUTER_API_KEY')
+    if not api_key:
+        return "Error: OPENROUTER_API_KEY not set. Please set your OpenRouter API key in environment variables or Hugging Face Secrets."
+
+    messages = [
+        {
+            "role": "system",
+            "content": "You are a wise and ancient dream interpreter named 'Morphius'. Your interpretations are insightful, drawing from symbolism, psychology, and mythology. You should not give definitive predictions, but rather thoughtful reflections on the user's subconscious mind. Your tone is calm, poetic, and slightly mysterious. Never break character. When a user tells you their dream, analyze the key symbols and provide a beautiful, multi-paragraph interpretation. Start your response with 'O seeker of truths in the realm of slumber...' and end with 'May your waking path be as insightful as your dreams.' Do not mention that you are an AI model."
+        },
+        {
+            "role": "user",
+            "content": dream_text
+        }
+    ]
+
+    url = 'https://openrouter.ai/api/v1/chat/completions'
+    headers = {
+        'Authorization': f'Bearer {api_key}',
+        'Content-Type': 'application/json'
+    }
+    body = {
+        'model': 'google/gemma-2-27b-it',
+        'messages': messages
+    }
+
+    try:
+        response = requests.post(url, json=body, headers=headers)
+        response.raise_for_status()
+        return response.json()['choices'][0]['message']['content']
+    except Exception as e:
+        return f"Error: {str(e)}"
+
+interface = gr.Interface(
+    fn=interpret_dream,
+    inputs=gr.Textbox(lines=10, placeholder="...write your dream here"),
+    outputs=gr.Markdown(),
+    title="Smart Dream Interpreter (Morphius)",
+    description="Deep into the depths of your dreams. Morpheus, the ancient interpreter, is ready to listen to your nightly stories.",
+    examples=[
+        [
+            "I dreamed of flying over mountains.",
+            """O seeker of truths in the realm of slumber, your vision of soaring above jagged peaks whispers of liberation and aspiration. Mountains, ancient sentinels of the earth, symbolize obstacles overcome, while flight evokes the soul's yearning for transcendence. In the quiet chambers of your mind, this dream may reflect a desire to rise above earthly burdens, embracing the winds of change with fearless grace.
+
+Yet, consider the heights you attain—do they bring serenity or a fleeting thrill? The subconscious often paints such scenes to remind us of our inner strength, urging us to navigate life's summits with wisdom drawn from the myths of Icarus and the eagles of old. May your waking path be as insightful as your dreams."""
+        ],
+        [
+            "I was lost in a dark forest.",
+            """O seeker of truths in the realm of slumber, wandering amidst shadowed trees speaks to the labyrinth of the psyche, where clarity eludes and mysteries abound. The forest, a timeless archetype of the unknown, mirrors feelings of disorientation in waking life—perhaps a quest for self-discovery amid confusion.
+
+In psychological depths, this gloom may symbolize repressed fears or untrodden paths of emotion, echoing the mythic journeys of heroes like Dante through infernal woods. Embrace this as an invitation to illuminate your inner world, finding direction through intuition's gentle light. May your waking path be as insightful as your dreams."""
+        ],
+        [
+            "A snake bit me in the garden.",
+            """O seeker of truths in the realm of slumber, the serpent's strike in Eden's embrace unveils transformation and hidden wisdom. Snakes, coiled symbols from ancient lore, represent renewal through shedding skin, yet their bite warns of betrayal or awakening pains in the subconscious garden of desires.
+
+Drawing from Jungian shadows, this may reflect confrontations with instinctual forces or healing crises, reminiscent of the Garden of Eden's fateful encounter. Ponder the venom's message: is it poison or potion for growth? Let it guide you toward balance between temptation and enlightenment. May your waking path be as insightful as your dreams."""
+        ]
+    ]
+)
+
+demo = interface.launch()

app.pyZone.Identifier

@@ -0,0 +1,2 @@
+[ZoneTransfer]
+ZoneId=3