README.md

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

# Mental Wellness Platform

A comprehensive mental wellness support system powered by AI, deployed on Hugging Face Spaces.

## Features
- 🤖 Multi-agent AI support system
- 💬 Natural therapeutic conversations
- 📊 Mental health assessments
- 🧘‍♀️ Guided meditation and mindfulness
- 🚨 Crisis intervention support
- 📱 Multi-modal interaction (text, voice, image)
- 📈 Comprehensive logging and analytics
- 🔄 Automatic log rotation and management

## System Components
- Therapeutic Conversation Agent
- Assessment Agent
- Mindfulness Agent
- Crisis Intervention Agent
- Analytics and Logging System

## Logging System
The platform includes a comprehensive logging system with:
- Agent-specific logs
- System health monitoring
- Analytics tracking
- Performance metrics
- Security event logging
- Automatic log rotation
- Log cleanup for older files

### Log Categories
1. Agent Logs (`logs/agents/`)
   - Individual agent activities
   - Performance metrics
   - Error tracking

2. System Logs (`logs/system/`)
   - System health
   - Resource usage
   - General operations

3. Analytics Logs (`logs/analytics/`)
   - User interactions
   - Session metrics
   - Model performance
   - Usage statistics

## Usage
1. Open the chat interface
2. Type your message or use voice/image input
3. Choose from available tools:
   - Mental Health Check
   - Start Meditation
   - View Resources

## Important Note
This is an AI-powered support tool and not a substitute for professional mental health care. In case of emergency:
- Call emergency services: 911 (US)
- National Crisis Hotline: 988
- Crisis Text Line: Text HOME to 741741

## Technical Details
Built with:
- Gradio for interface
- Hugging Face Transformers for AI models
- CrewAI for multi-agent orchestration
- Advanced voice and image processing
- Comprehensive logging system

## Development
To run locally:
1. Clone the repository
2. Install dependencies:
   ```bash
   pip install -r requirements.txt
   ```
3. Run the application:
   ```bash
   python app.py
   ```

## Monitoring
The system includes:
- Real-time performance monitoring
- Error tracking and alerts
- Usage analytics
- System health metrics

## Security
- All conversations are encrypted
- Comprehensive security logging
- Access control and monitoring
- Data retention policies

## License
MIT License

## Authors
Created by Invincible Jha

## Acknowledgments
- CrewAI for the multi-agent framework
- Hugging Face for AI models and hosting
- Gradio for the interface framework