README.md

---
title: DreamWeaver AI - Local Transformers
emoji: 🌙
colorFrom: indigo
colorTo: purple
sdk: gradio
sdk_version: 4.44.0
python_version: "3.10"
app_file: app.py
pinned: false
license: mit
short_description: Dream journal & interpreter (local Transformers)
---

# 🌙 DreamWeaver AI - Dream Journal & Interpreter

An innovative AI-powered dream analysis tool that interprets your dreams, identifies emotional themes, and generates creative dream-inspired stories.

## Features

- 🎭 **Emotional Analysis**: Detect the emotional undertones of your dreams
- 🔮 **Symbol Detection**: Identify and interpret common dream symbols  
- 📖 **AI Interpretation**: Get personalized dream interpretations
- ✨ **Story Generation**: Transform dreams into creative stories
- 🎨 **Visual Prompts**: Generate prompts for AI image generators
- 📔 **Dream Journal**: Save and format your dream entries

## Architecture

This is the **Local Transformers Version** which uses:
- `transformers` pipelines for model inference (models are downloaded to the Space)
- Gradio for the user interface
- Hosted on Hugging Face Spaces

## Models Used

- `j-hartmann/emotion-english-distilroberta-base` - Emotion classification
- `distilgpt2` - Lightweight text generation for interpretations and stories

## Citations

- Hugging Face Transformers Documentation
- Gradio Documentation
- Dream symbolism inspired by Jungian psychology
- GitHub Copilot for code assistance