---
title: Mental Wellness Assistant
emoji: 🧠
colorFrom: indigo
colorTo: purple
sdk: gradio
sdk_version: 5.8.0
app_file: app.py
pinned: false
license: mit
---

# Mental Wellness Assistant

A sophisticated AI-powered mental wellness assistant using state-of-the-art Mistral-7B language models. This application provides both therapeutic conversation and mindfulness guidance through an intuitive chat interface.

## Features

### 1. Dual-Agent System
- **Therapeutic Agent**: Provides empathetic conversations and emotional support
- **Mindfulness Agent**: Offers guided meditation and mindfulness exercises

### 2. Advanced AI Capabilities
- Powered by Mistral-7B-Instruct-v0.2
- Context-aware responses
- Natural conversation flow

### 3. User Interface
- Clean, intuitive chat interface
- Easy switching between therapeutic and mindfulness modes
- Example prompts for quick start

## Technical Details

### Requirements
- Python 3.8+
- CUDA-compatible GPU recommended
- 16GB+ RAM recommended

### Key Dependencies
- Gradio: Web interface
- Transformers: Hugging Face model support
- PyTorch: Deep learning framework
- Hugging Face Hub: Model hosting and management

### Model Information
- Base Model: Mistral-7B-Instruct-v0.2
- Optimization: 16-bit precision for efficiency
- Auto device mapping for optimal resource usage

## Usage

1. **Mode Selection**
   - Choose between "Therapeutic Mode" and "Mindfulness Mode"
   - Each mode provides specialized responses for different needs

2. **Conversation**
   - Type your message in the chat interface
   - Get AI-generated responses based on the selected mode
   - Use example prompts for guidance

3. **Example Interactions**
   - "I've been feeling anxious lately"
   - "Guide me through a breathing exercise"
   - "I need help managing stress"
   - "Can you teach me meditation?"

## Important Disclaimers

1. **Not a Medical Service**
   - This is a demonstration project
   - Not a substitute for professional mental health care
   - Seek professional help for serious concerns

2. **Privacy Notice**
   - Conversations are not stored permanently
   - Data is processed securely
   - Use discretion when sharing personal information

## Emergency Resources

If you're experiencing a mental health crisis:
- Emergency Services: 911 (US)
- National Crisis Hotline: 988
- Crisis Text Line: Text HOME to 741741

## Development

### Local Setup
1. Clone the repository
2. Install dependencies: `pip install -r requirements.txt`
3. Set up HF_TOKEN in environment variables
4. Run: `python app.py`

### Hugging Face Spaces
This application is deployed on Hugging Face Spaces and uses:
- Gradio SDK
- Environment variables for secure token management
- Automated logging for monitoring

## License

MIT License - Feel free to use and modify with attribution

## Acknowledgments

- Mistral AI for the base model
- Hugging Face for model hosting and tools
- Gradio team for the interface framework