om-cli 0.1.0
Advanced Mental Health CLI Platform - Privacy-first wellness toolkit with AI coaching, CBT tools, crisis support, and evidence-based interventions
Requires Python: >=3.11
Keywords: mental-health, wellness, cli, mindfulness, meditation, cbt, therapy, anxiety, depression, self-care, privacy, terminal, coaching, crisis-support, mood-tracking

# om 🧘‍♀️

**Advanced Mental Health CLI Platform with AI-Powered Wellness**

[![PyPI version](https://badge.fury.io/py/om-cli.svg)](https://badge.fury.io/py/om-cli)
[![Python](https://img.shields.io/badge/Python-3.11+-blue)](requirements.txt)
[![License](https://img.shields.io/badge/License-MIT-blue)](LICENSE)
[![Privacy](https://img.shields.io/badge/Privacy-100%25%20Local-green)](#privacy--security)

> *"Mental wellness, compiled locally"*

A comprehensive command-line mental health companion featuring evidence-based interventions, AI coaching, and real-time wellness tracking. Built with privacy-first architecture and inspired by leading mental health research.

```
+-------------------------------------+
|  $ om                               |
|                                     |
|      ╭─╮ ╭─╮                        |
|      │ │ │ │                        |
|      ╰─╯ ╰─╯                        |
|                                     |
|  o breathe o reflect o grow         |
|                                     |
|  your terminal wellness companion   |
+-------------------------------------+
```

## 🚀 Quick Install

```bash
pip install om-cli
```

## ✨ Quick Start

```bash
# Start your wellness journey
om qm          # Quick mood check
om qb          # Breathing exercise
om rescue      # Crisis support
om coach daily # AI insights
```

### **🧠 Core Features**

### **Evidence-Based Mental Health Tools**
- **CBT Toolkit** - Thought challenging, anxiety management, cognitive distortion detection
- **AI Companion** - 24/7 conversational support with crisis detection
- **Enhanced Chatbot** - Therapeutic conversation patterns with om tool integration
- **Crisis Support** - Immediate access to emergency resources and grounding techniques
- **Addiction Recovery** - Evidence-based tools for substance abuse recovery (inspired by Try Dry®)
- **Body Image Support** - Self-acceptance and body positivity tools
- **Hypnosis Sessions** - Digital hypnosis and guided visualization (inspired by Hypnomatic)

### **⚡ Ultra-Fast Quick Actions**
```bash
om qm          # Quick mood check (10 seconds)
om qb          # 4-7-8 breathing exercise (2 minutes)  
om qg          # Gratitude practice (30 seconds)
om qf          # Focus reset (1 minute)
om qc          # Progressive relaxation (90 seconds)
om qcap        # Quick thought capture
```

### **🌙 Sleep & Wellness Optimization**
- **Sleep Cycle Calculator** - Optimal bedtimes based on 90-minute cycles
- **Sleep Sounds** - 18 therapeutic audio tracks for anxiety, ADHD, PTSD
- **Positive Psychology** - Three Good Things, character strengths, gratitude practices
- **Daily Check-ins** - Morning and evening wellness routines
- **Guided Journals** - Therapeutic journaling with structured prompts
- **Learning Paths** - Structured mental health education modules

### **🎯 Advanced Analytics & AI**
- **Enhanced Mood Tracking** - 60+ emotions with pattern recognition
- **AI Mental Health Coach** - Personalized insights and recommendations
- **Emotion Analysis** - Deep pattern recognition in emotional states
- **Smart Suggestions** - AI-powered wellness recommendations
- **Wellness Dashboard** - Real-time progress visualization
- **Gamification** - Achievement system with 25+ wellness milestones

## 🌟 Revolutionary Philosophy

### **Fear as Friend** 🐺
Based on Nicky Case's groundbreaking "How to Mental Health" essay:
```bash
om wolf        # Talk to your inner anxiety with compassion
om nicky       # Explore 9 evidence-based habits for wellbeing
```

> *"Your fear is not your enemy - it's a guard dog for your needs."*

## 🔒 Privacy & Security

### **100% Local Processing**
- ✅ **No cloud sync** - All data stays on your device
- ✅ **No external APIs** - Complete offline functionality  
- ✅ **No tracking** - Zero analytics or data collection
- ✅ **User controlled** - Delete your data anytime

### **Data Location**
```
~/.om/
├── mood_data.json           # Your emotional journey
├── wellness_stats.json      # Progress tracking
├── ai_conversations.json    # AI companion chats
└── crisis_support.json      # Safety planning (encrypted)
```

## 🆘 Crisis Support

**Immediate help available 24/7:**
```bash
om rescue      # Crisis resources and emergency contacts
om qgr         # 5-4-3-2-1 grounding technique
```

**Emergency Resources:**
- 🇺🇸 National Suicide Prevention Lifeline: **988**
- 🇺🇸 Crisis Text Line: Text **HOME** to **741741**
- 🌍 International crisis resources for 15+ countries

## 📚 Evidence-Based Foundation

Every feature is backed by peer-reviewed research:
- **CBT Techniques** - Most researched form of psychotherapy
- **Positive Psychology** - Martin Seligman's happiness research
- **Sleep Science** - Circadian rhythm optimization
- **AI Mental Health** - Digital therapeutics effectiveness studies

## 🤖 AI-Powered Features

### **Mental Health Coach**
```bash
om coach daily     # Get personalized daily insights
om coach analyze   # Deep pattern analysis
```

### **Enhanced Chatbot**
```bash
om chatbot         # Therapeutic conversations with crisis detection
```

### **Wellness Autopilot**
```bash
om autopilot       # Automated wellness task generation
```

## 🎮 Gamification & Progress

```bash
om gamify status    # View achievements and progress
```

**Achievement Categories:**
- 🌱 Mood Tracking milestones
- 🫁 Breathing practice consistency  
- 🙏 Gratitude streaks
- 🔥 Daily wellness habits
- 🎯 Crisis recovery support

## 🌍 Global Impact

**Supporting mental health worldwide:**
- 🇺🇸 🇬🇧 🇨🇦 🇦🇺 🇩🇪 Crisis resources for 15+ countries
- 🌐 Multi-language support (planned)
- 🏥 Integration with mental health professionals
- 🎓 Educational resources and research backing

## 🛠️ Installation

### **Requirements**
- Python 3.11+
- 50MB disk space
- Terminal access

### **Install from PyPI**
```bash
pip install om-cli
```

### **Install from Source**
```bash
git clone https://github.com/frism/om.git
cd om
pip install -r requirements.txt
python setup.py install
```

### **Verify Installation**
```bash
om --version
om --help
om qm
```

## 📖 Complete Documentation

- 📘 **[Full Documentation](https://frism.github.io/om/)** - Comprehensive guides
- 🚀 **[Quick Start](https://frism.github.io/om/quickstart.html)** - Get started in 5 minutes
- 🧠 **[CBT Toolkit](https://frism.github.io/om/cbt_toolkit.html)** - Cognitive behavioral therapy tools
- 🤖 **[AI Companion](https://frism.github.io/om/ai_companion.html)** - AI mental health support
- 🆘 **[Crisis Support](https://frism.github.io/om/rescue_sessions.html)** - Emergency resources

## 🤝 Contributing

We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

**Ways to help:**
- 🐛 Report bugs and issues
- 💡 Suggest evidence-based features
- 📝 Improve documentation
- 🌍 Add translations
- 💻 Contribute code

## 📊 Project Stats

- **47 Python modules** with comprehensive mental health features
- **18/19 modules documented** (95% coverage)
- **25+ achievements** in gamification system
- **15+ countries** with crisis support resources
- **60+ emotions** in enhanced mood tracking
- **100% privacy-respecting** architecture

## 🏆 Why Choose om-cli?

| Feature | om-cli | Headspace | Calm | BetterHelp |
|---------|--------|-----------|------|------------|
| **Privacy** | 100% Local | ❌ Cloud | ❌ Cloud | ❌ Cloud |
| **Cost** | Free | $12.99/mo | $14.99/mo | $80/week |
| **Crisis Support** | ✅ Global | ❌ None | ❌ None | ⚠️ Limited |
| **AI Coaching** | ✅ Personal | ❌ None | ❌ None | ✅ Human |
| **Offline Access** | ✅ Always | ❌ Limited | ❌ Limited | ❌ None |
| **Data Export** | ✅ Anytime | ❌ None | ❌ None | ❌ None |
| **Open Source** | ✅ MIT | ❌ Proprietary | ❌ Proprietary | ❌ Proprietary |

## 💝 Support the Project

If om-cli has helped your mental wellness journey:

[![Ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/omcli)

Your support helps:
- Keep om-cli free and open source
- Fund new evidence-based features
- Support crisis intervention resources
- Maintain privacy-first development

## 📄 License & Disclaimer

**MIT License** - Use, modify, and distribute freely.

**Medical Disclaimer**: om-cli is a wellness tool designed to complement, not replace, professional mental health care. For mental health emergencies, contact emergency services or crisis hotlines immediately.

## 🙏 Acknowledgments

**Built with love for the mental health community:**
- Mental health professionals who provided guidance
- Nicky Case for revolutionary mental health insights
- Open source contributors and beta testers
- The research community for evidence-based interventions

---

<div align="center">

**🧘‍♀️ Take care of yourself. You deserve wellness and happiness. 🧘‍♂️**

**[PyPI](https://pypi.org/project/om-cli/) • [GitHub](https://github.com/frism/om) • [Documentation](docs/) • [Support](https://ko-fi.com/omcli)**

*Made with ❤️ for mental health and wellness*

</div>

---

**Your mental health journey starts with one command:**
```bash
pip install om-cli && om qm
```