README.md

metadata

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:

   pip install -r requirements.txt
   

3. Run the application:

   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