# om 🧘♀️
**Advanced Mental Health CLI Platform with AI-Powered Wellness**
[](https://badge.fury.io/py/om-cli)
[](requirements.txt)
[](LICENSE)
[](#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:
[](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
```
Raw data
{
"_id": null,
"home_page": "https://github.com/frism/om",
"name": "om-cli",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "mental-health, wellness, cli, mindfulness, meditation, cbt, therapy, anxiety, depression, self-care, privacy, terminal, coaching, crisis-support, mood-tracking",
"author": "frism",
"author_email": "contact@om-cli.org",
"download_url": "https://files.pythonhosted.org/packages/b5/c6/ffd5e687057ef847d0747079330fc4851ddb3ec6031e5b6a7e077b8f4990/om_cli-0.1.0.tar.gz",
"platform": null,
"description": "# om \ud83e\uddd8\u200d\u2640\ufe0f\n\n**Advanced Mental Health CLI Platform with AI-Powered Wellness**\n\n[](https://badge.fury.io/py/om-cli)\n[](requirements.txt)\n[](LICENSE)\n[](#privacy--security)\n\n> *\"Mental wellness, compiled locally\"*\n\nA 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.\n\n```\n+-------------------------------------+\n| $ om |\n| |\n| \u256d\u2500\u256e \u256d\u2500\u256e |\n| \u2502 \u2502 \u2502 \u2502 |\n| \u2570\u2500\u256f \u2570\u2500\u256f |\n| |\n| o breathe o reflect o grow |\n| |\n| your terminal wellness companion |\n+-------------------------------------+\n```\n\n## \ud83d\ude80 Quick Install\n\n```bash\npip install om-cli\n```\n\n## \u2728 Quick Start\n\n```bash\n# Start your wellness journey\nom qm # Quick mood check\nom qb # Breathing exercise\nom rescue # Crisis support\nom coach daily # AI insights\n```\n\n### **\ud83e\udde0 Core Features**\n\n### **Evidence-Based Mental Health Tools**\n- **CBT Toolkit** - Thought challenging, anxiety management, cognitive distortion detection\n- **AI Companion** - 24/7 conversational support with crisis detection\n- **Enhanced Chatbot** - Therapeutic conversation patterns with om tool integration\n- **Crisis Support** - Immediate access to emergency resources and grounding techniques\n- **Addiction Recovery** - Evidence-based tools for substance abuse recovery (inspired by Try Dry\u00ae)\n- **Body Image Support** - Self-acceptance and body positivity tools\n- **Hypnosis Sessions** - Digital hypnosis and guided visualization (inspired by Hypnomatic)\n\n### **\u26a1 Ultra-Fast Quick Actions**\n```bash\nom qm # Quick mood check (10 seconds)\nom qb # 4-7-8 breathing exercise (2 minutes) \nom qg # Gratitude practice (30 seconds)\nom qf # Focus reset (1 minute)\nom qc # Progressive relaxation (90 seconds)\nom qcap # Quick thought capture\n```\n\n### **\ud83c\udf19 Sleep & Wellness Optimization**\n- **Sleep Cycle Calculator** - Optimal bedtimes based on 90-minute cycles\n- **Sleep Sounds** - 18 therapeutic audio tracks for anxiety, ADHD, PTSD\n- **Positive Psychology** - Three Good Things, character strengths, gratitude practices\n- **Daily Check-ins** - Morning and evening wellness routines\n- **Guided Journals** - Therapeutic journaling with structured prompts\n- **Learning Paths** - Structured mental health education modules\n\n### **\ud83c\udfaf Advanced Analytics & AI**\n- **Enhanced Mood Tracking** - 60+ emotions with pattern recognition\n- **AI Mental Health Coach** - Personalized insights and recommendations\n- **Emotion Analysis** - Deep pattern recognition in emotional states\n- **Smart Suggestions** - AI-powered wellness recommendations\n- **Wellness Dashboard** - Real-time progress visualization\n- **Gamification** - Achievement system with 25+ wellness milestones\n\n## \ud83c\udf1f Revolutionary Philosophy\n\n### **Fear as Friend** \ud83d\udc3a\nBased on Nicky Case's groundbreaking \"How to Mental Health\" essay:\n```bash\nom wolf # Talk to your inner anxiety with compassion\nom nicky # Explore 9 evidence-based habits for wellbeing\n```\n\n> *\"Your fear is not your enemy - it's a guard dog for your needs.\"*\n\n## \ud83d\udd12 Privacy & Security\n\n### **100% Local Processing**\n- \u2705 **No cloud sync** - All data stays on your device\n- \u2705 **No external APIs** - Complete offline functionality \n- \u2705 **No tracking** - Zero analytics or data collection\n- \u2705 **User controlled** - Delete your data anytime\n\n### **Data Location**\n```\n~/.om/\n\u251c\u2500\u2500 mood_data.json # Your emotional journey\n\u251c\u2500\u2500 wellness_stats.json # Progress tracking\n\u251c\u2500\u2500 ai_conversations.json # AI companion chats\n\u2514\u2500\u2500 crisis_support.json # Safety planning (encrypted)\n```\n\n## \ud83c\udd98 Crisis Support\n\n**Immediate help available 24/7:**\n```bash\nom rescue # Crisis resources and emergency contacts\nom qgr # 5-4-3-2-1 grounding technique\n```\n\n**Emergency Resources:**\n- \ud83c\uddfa\ud83c\uddf8 National Suicide Prevention Lifeline: **988**\n- \ud83c\uddfa\ud83c\uddf8 Crisis Text Line: Text **HOME** to **741741**\n- \ud83c\udf0d International crisis resources for 15+ countries\n\n## \ud83d\udcda Evidence-Based Foundation\n\nEvery feature is backed by peer-reviewed research:\n- **CBT Techniques** - Most researched form of psychotherapy\n- **Positive Psychology** - Martin Seligman's happiness research\n- **Sleep Science** - Circadian rhythm optimization\n- **AI Mental Health** - Digital therapeutics effectiveness studies\n\n## \ud83e\udd16 AI-Powered Features\n\n### **Mental Health Coach**\n```bash\nom coach daily # Get personalized daily insights\nom coach analyze # Deep pattern analysis\n```\n\n### **Enhanced Chatbot**\n```bash\nom chatbot # Therapeutic conversations with crisis detection\n```\n\n### **Wellness Autopilot**\n```bash\nom autopilot # Automated wellness task generation\n```\n\n## \ud83c\udfae Gamification & Progress\n\n```bash\nom gamify status # View achievements and progress\n```\n\n**Achievement Categories:**\n- \ud83c\udf31 Mood Tracking milestones\n- \ud83e\udec1 Breathing practice consistency \n- \ud83d\ude4f Gratitude streaks\n- \ud83d\udd25 Daily wellness habits\n- \ud83c\udfaf Crisis recovery support\n\n## \ud83c\udf0d Global Impact\n\n**Supporting mental health worldwide:**\n- \ud83c\uddfa\ud83c\uddf8 \ud83c\uddec\ud83c\udde7 \ud83c\udde8\ud83c\udde6 \ud83c\udde6\ud83c\uddfa \ud83c\udde9\ud83c\uddea Crisis resources for 15+ countries\n- \ud83c\udf10 Multi-language support (planned)\n- \ud83c\udfe5 Integration with mental health professionals\n- \ud83c\udf93 Educational resources and research backing\n\n## \ud83d\udee0\ufe0f Installation\n\n### **Requirements**\n- Python 3.11+\n- 50MB disk space\n- Terminal access\n\n### **Install from PyPI**\n```bash\npip install om-cli\n```\n\n### **Install from Source**\n```bash\ngit clone https://github.com/frism/om.git\ncd om\npip install -r requirements.txt\npython setup.py install\n```\n\n### **Verify Installation**\n```bash\nom --version\nom --help\nom qm\n```\n\n## \ud83d\udcd6 Complete Documentation\n\n- \ud83d\udcd8 **[Full Documentation](https://frism.github.io/om/)** - Comprehensive guides\n- \ud83d\ude80 **[Quick Start](https://frism.github.io/om/quickstart.html)** - Get started in 5 minutes\n- \ud83e\udde0 **[CBT Toolkit](https://frism.github.io/om/cbt_toolkit.html)** - Cognitive behavioral therapy tools\n- \ud83e\udd16 **[AI Companion](https://frism.github.io/om/ai_companion.html)** - AI mental health support\n- \ud83c\udd98 **[Crisis Support](https://frism.github.io/om/rescue_sessions.html)** - Emergency resources\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n**Ways to help:**\n- \ud83d\udc1b Report bugs and issues\n- \ud83d\udca1 Suggest evidence-based features\n- \ud83d\udcdd Improve documentation\n- \ud83c\udf0d Add translations\n- \ud83d\udcbb Contribute code\n\n## \ud83d\udcca Project Stats\n\n- **47 Python modules** with comprehensive mental health features\n- **18/19 modules documented** (95% coverage)\n- **25+ achievements** in gamification system\n- **15+ countries** with crisis support resources\n- **60+ emotions** in enhanced mood tracking\n- **100% privacy-respecting** architecture\n\n## \ud83c\udfc6 Why Choose om-cli?\n\n| Feature | om-cli | Headspace | Calm | BetterHelp |\n|---------|--------|-----------|------|------------|\n| **Privacy** | 100% Local | \u274c Cloud | \u274c Cloud | \u274c Cloud |\n| **Cost** | Free | $12.99/mo | $14.99/mo | $80/week |\n| **Crisis Support** | \u2705 Global | \u274c None | \u274c None | \u26a0\ufe0f Limited |\n| **AI Coaching** | \u2705 Personal | \u274c None | \u274c None | \u2705 Human |\n| **Offline Access** | \u2705 Always | \u274c Limited | \u274c Limited | \u274c None |\n| **Data Export** | \u2705 Anytime | \u274c None | \u274c None | \u274c None |\n| **Open Source** | \u2705 MIT | \u274c Proprietary | \u274c Proprietary | \u274c Proprietary |\n\n## \ud83d\udc9d Support the Project\n\nIf om-cli has helped your mental wellness journey:\n\n[](https://ko-fi.com/omcli)\n\nYour support helps:\n- Keep om-cli free and open source\n- Fund new evidence-based features\n- Support crisis intervention resources\n- Maintain privacy-first development\n\n## \ud83d\udcc4 License & Disclaimer\n\n**MIT License** - Use, modify, and distribute freely.\n\n**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.\n\n## \ud83d\ude4f Acknowledgments\n\n**Built with love for the mental health community:**\n- Mental health professionals who provided guidance\n- Nicky Case for revolutionary mental health insights\n- Open source contributors and beta testers\n- The research community for evidence-based interventions\n\n---\n\n<div align=\"center\">\n\n**\ud83e\uddd8\u200d\u2640\ufe0f Take care of yourself. You deserve wellness and happiness. \ud83e\uddd8\u200d\u2642\ufe0f**\n\n**[PyPI](https://pypi.org/project/om-cli/) \u2022 [GitHub](https://github.com/frism/om) \u2022 [Documentation](docs/) \u2022 [Support](https://ko-fi.com/omcli)**\n\n*Made with \u2764\ufe0f for mental health and wellness*\n\n</div>\n\n---\n\n**Your mental health journey starts with one command:**\n```bash\npip install om-cli && om qm\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Advanced Mental Health CLI Platform - Privacy-first wellness toolkit with AI coaching, CBT tools, crisis support, and evidence-based interventions",
"version": "0.1.0",
"project_urls": {
"Bug Reports": "https://github.com/frism/om/issues",
"Documentation": "https://github.com/frism/om/tree/main/docs",
"Funding": "https://ko-fi.com/omcli",
"Homepage": "https://github.com/frism/om",
"Source": "https://github.com/frism/om"
},
"split_keywords": [
"mental-health",
" wellness",
" cli",
" mindfulness",
" meditation",
" cbt",
" therapy",
" anxiety",
" depression",
" self-care",
" privacy",
" terminal",
" coaching",
" crisis-support",
" mood-tracking"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "5462843f4ae5359f58a2df45c6c067dd77fa44892b6683bbd3b3f43bb1b25ff1",
"md5": "91f76180e8984c1b25084a994ee814c7",
"sha256": "492e198f33469041cbe33f356028c91caba40dd67f36249ab558befbc29ca2fb"
},
"downloads": -1,
"filename": "om_cli-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "91f76180e8984c1b25084a994ee814c7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 298180,
"upload_time": "2025-07-27T19:41:13",
"upload_time_iso_8601": "2025-07-27T19:41:13.908189Z",
"url": "https://files.pythonhosted.org/packages/54/62/843f4ae5359f58a2df45c6c067dd77fa44892b6683bbd3b3f43bb1b25ff1/om_cli-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b5c6ffd5e687057ef847d0747079330fc4851ddb3ec6031e5b6a7e077b8f4990",
"md5": "862d77318283f095af8320e9031158d5",
"sha256": "a2596af787c4c54c413c4cf70215fb249d2c99a92b1c954ac3e1e95fcd0ab98a"
},
"downloads": -1,
"filename": "om_cli-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "862d77318283f095af8320e9031158d5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 488984,
"upload_time": "2025-07-27T19:41:15",
"upload_time_iso_8601": "2025-07-27T19:41:15.508949Z",
"url": "https://files.pythonhosted.org/packages/b5/c6/ffd5e687057ef847d0747079330fc4851ddb3ec6031e5b6a7e077b8f4990/om_cli-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-27 19:41:15",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "frism",
"github_project": "om",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "rich",
"specs": [
[
">=",
"13.0.0"
]
]
},
{
"name": "textual",
"specs": [
[
">=",
"0.40.0"
]
]
},
{
"name": "click",
"specs": [
[
">=",
"8.0.0"
]
]
},
{
"name": "colorama",
"specs": [
[
">=",
"0.4.6"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.28.0"
]
]
},
{
"name": "flask",
"specs": [
[
">=",
"2.3.0"
]
]
},
{
"name": "pygame",
"specs": [
[
">=",
"2.1.0"
]
]
},
{
"name": "pytest",
"specs": [
[
">=",
"7.0.0"
]
]
},
{
"name": "sphinx",
"specs": [
[
">=",
"5.0.0"
]
]
}
],
"lcname": "om-cli"
}
JSON
