README.md

# Mental Wellness Platform

A comprehensive mental wellness platform that provides mental health assessment, monitoring, and support through multiple modalities. The platform utilizes state-of-the-art AI models for voice analysis, text analysis, and therapeutic interaction.

## Features

- **Voice Analysis**
  - Speech recognition and transcription
  - Emotion detection from voice
  - Prosodic feature analysis
  - Speech pattern analysis

- **Text Analysis**
  - Sentiment analysis
  - Emotion detection
  - Mental health indicator detection
  - Cognitive state assessment

- **Therapeutic Support**
  - AI-powered therapeutic conversations
  - Personalized coping strategies
  - Crisis detection and support
  - Mental health resources

## Installation

1. Clone the repository:
```bash
git clone https://github.com/yourusername/mental-wellness-platform.git
cd mental-wellness-platform
```

2. Create a virtual environment and activate it:
```bash
python -m venv venv
source venv/bin/activate  # On Windows, use: venv\Scripts\activate
```

3. Install the required packages:
```bash
pip install -r requirements.txt
```

## Usage

1. Start the application:
```bash
python src/app.py
```

2. Open your web browser and navigate to the provided URL (typically http://localhost:7860)

3. Use the platform's features through the Gradio interface:
   - Record voice input for analysis
   - Enter text for emotional analysis
   - Engage in therapeutic conversation
   - View analysis results and recommendations

## Model Information

The platform uses the following models:
- Whisper ASR for speech recognition
- DistilRoBERTa for emotion classification
- FLAN-T5 for therapeutic responses
- Various custom models for mental health assessment

## Privacy and Security

- All data is processed locally
- No data is stored permanently
- End-to-end encryption for data transmission
- Compliant with privacy best practices

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## License

This project is licensed under the MIT License - see the LICENSE file for details.

## Disclaimer

This platform is not a substitute for professional mental health care. If you're experiencing a mental health crisis, please contact your local emergency services or call the National Crisis Helpline at 988.

## Support

For questions, issues, or feature requests, please open an issue on the GitHub repository.