{"id":48341574,"url":"https://github.com/ziggythebot/couples-therapy-bot","last_synced_at":"2026-04-05T05:03:28.237Z","repository":{"id":348910979,"uuid":"1199617494","full_name":"ziggythebot/couples-therapy-bot","owner":"ziggythebot","description":"AI-powered couples therapy combining structured interviews, WhatsApp chat analysis, and real-time sessions. Integrates Gottman Method + EFT with Claude AI and Tavus avatars.","archived":false,"fork":false,"pushed_at":"2026-04-03T11:34:39.000Z","size":36,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-03T15:50:54.907Z","etag":null,"topics":["ai","claude-ai","couples-therapy","eft","gottman-method","mental-health","relationship","tavus","therapy","whatsapp"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ziggythebot.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"b1rdmania"}},"created_at":"2026-04-02T14:29:01.000Z","updated_at":"2026-04-03T11:34:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ziggythebot/couples-therapy-bot","commit_stats":null,"previous_names":["ziggythebot/couples-therapy-bot"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ziggythebot/couples-therapy-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziggythebot%2Fcouples-therapy-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziggythebot%2Fcouples-therapy-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziggythebot%2Fcouples-therapy-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziggythebot%2Fcouples-therapy-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ziggythebot","download_url":"https://codeload.github.com/ziggythebot/couples-therapy-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziggythebot%2Fcouples-therapy-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31424932,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T02:22:46.605Z","status":"ssl_error","status_checked_at":"2026-04-05T02:22:33.263Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude-ai","couples-therapy","eft","gottman-method","mental-health","relationship","tavus","therapy","whatsapp"],"created_at":"2026-04-05T05:03:08.351Z","updated_at":"2026-04-05T05:03:28.223Z","avatar_url":"https://github.com/ziggythebot.png","language":null,"funding_links":["https://github.com/sponsors/b1rdmania"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Couples Therapy Bot\n\n**AI-powered couples therapy combining structured interviews, communication analysis, and real-time sessions**\n\n[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Status](https://img.shields.io/badge/Status-Planning-yellow)](https://github.com/ziggythebot/couples-therapy-bot)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)\n\n[Architecture](#architecture) • [Therapeutic Foundation](#therapeutic-foundation) • [Documentation](#documentation) • [Contributing](#contributing)\n\n\u003c/div\u003e\n\n---\n\n## Overview\n\nDesigned to make high-quality couples therapy accessible—replicating the experience that would cost **$200+/hour** in cities like London or New York.\n\nThis system integrates evidence-based therapeutic models (Gottman Method + EFT) with modern AI technology to provide structured relationship support through asynchronous interviews, behavioral analysis, and real-time joint sessions.\n\n## Therapeutic Foundation\n\nThis system integrates evidence-based therapeutic models:\n\n### **Gottman Method** (Behavioral \u0026 Communication Focus)\n- **Four Horsemen Analysis**: Identifying criticism, contempt, defensiveness, stonewalling in communication\n- **Sound Relationship House**: Building friendship, managing conflict, creating shared meaning\n- **Conflict Management**: Distinguishing solvable vs perpetual problems\n- **Repair Attempts**: Recognizing and strengthening de-escalation patterns\n- **Behavioral Research**: 40+ years of empirical data on what predicts relationship success/failure\n\n### **Emotionally Focused Therapy (EFT)** (Attachment \u0026 Emotion Focus)\n- **Attachment Theory**: Understanding attachment styles, bonding patterns, security needs\n- **Emotional Accessibility**: Helping partners express vulnerable emotions beneath conflict\n- **Negative Cycles**: Mapping pursue-withdraw, attack-defend patterns\n- **Reprocessing Interactions**: Creating new emotional experiences in real-time\n- **Trauma-Informed**: Addressing past wounds affecting current relationship dynamics\n\n### **Integrated Approach**\nThe bot combines both models:\n- **Gottman's structure** for skill-building, assessment, and conflict analysis\n- **EFT's depth** for emotional safety, attachment repair, and vulnerability work\n- WhatsApp chat analysis provides behavioral data (Gottman-style)\n- Individual interviews explore attachment patterns (EFT-style)\n- Live sessions blend skill coaching with emotional processing\n\n## Architecture\n\n### Four-Phase Flow\n\n1. **Individual Interviews (Async)**\n   - Partner A: Psychological profile, attachment style, triggers, childhood patterns\n   - Partner B: Same structured interview\n   - Based on \"fix-life-in-1-day\" session structure\n\n2. **WhatsApp Chat Analysis**\n   - Ingest exported WhatsApp chat history\n   - Analyze communication patterns, conflict dynamics, repair attempts\n   - Identify escalation triggers, avoidance patterns, emotional regulation\n\n3. **Follow-up Interview**\n   - Targeted questions based on chat analysis\n   - Address gaps between self-perception and actual behavior\n   - Confront blind spots identified in communication patterns\n\n4. **Live Joint Session (Real-time)**\n   - 15-30 minute time-boxed discussion\n   - Tavus AI avatar for visual presence\n   - Claude backend with full context (profiles + chat analysis + follow-ups)\n   - Session transcripts saved to memory\n\n## Tech Stack\n\n- **LLM Backend**: Claude (via Anthropic API)\n- **Avatar**: Tavus AI (supports custom LLM integration)\n- **Memory**: Session-based persistence (partner profiles, chat analysis, transcripts)\n- **Chat Parsing**: WhatsApp export `.txt` format\n- **Framework**: Based on [fix-life-in-1-day](https://github.com/evgyur/fix-life-in-1-day) skill architecture\n\n## Quick Start\n\n\u003e **Note**: This project is in early planning phase. No implementation yet.\n\n```bash\n# Clone the repository\ngit clone https://github.com/ziggythebot/couples-therapy-bot.git\ncd couples-therapy-bot\n\n# Read the architecture\ncat ARCHITECTURE.md\n```\n\n## Project Status\n\n🟡 **Early Planning Phase**\n\n- [x] Architectural design complete\n- [x] Therapeutic models researched (Gottman + EFT)\n- [x] Technical stack defined (Claude + Tavus)\n- [ ] Interview structure implementation\n- [ ] WhatsApp parser development\n- [ ] Tavus integration\n- [ ] Memory system implementation\n\n**Roadmap**: Internal use first, potential scale later\n\n## Documentation\n\n- **[ARCHITECTURE.md](ARCHITECTURE.md)** - System design, components, memory structure, flow diagrams\n- **[TAVUS-INTEGRATION.md](TAVUS-INTEGRATION.md)** - Tavus AI avatar + Claude backend integration\n- **[INTERVIEW-STRUCTURE.md](INTERVIEW-STRUCTURE.md)** - Session templates, state management, question flows\n- **[WHATSAPP-ANALYSIS.md](WHATSAPP-ANALYSIS.md)** - Chat parsing strategy, analysis dimensions\n\n## References\n\n### Technical\n- [Tavus LLM Integration Docs](https://docs.tavus.io/sections/conversational-video-interface/persona/llm)\n- [fix-life-in-1-day Skill](https://github.com/evgyur/fix-life-in-1-day) (interview structure inspiration)\n- [Building Real-Time AI with Pipecat and Tavus](https://www.tavus.io/post/open-sourcing-ai-innovation-building-real-time-ai-interactions-with-pipecat-and-tavus)\n\n### Therapeutic Models\n- [Gottman Method \u0026 EFT Integration](https://www.gottman.com/blog/integrate-gottman-method-couples-therapy/)\n- [EFT vs Gottman: Comparison](https://familytherapybasics.com/blog/are-gottman-method-and-emotionally-focused-therapy-compatible)\n- [Gottman Method Research](https://www.gottman.com/about/research/)\n\n## Contributing\n\nContributions, feedback, and ideas are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n**Ways to contribute:**\n- 🧠 Share research on therapeutic models\n- 💡 Suggest interview questions or session structures\n- 🔧 Help with implementation (once development begins)\n- 📝 Improve documentation\n\n## Ethical Considerations\n\n**Important**: This system is designed to **supplement, not replace** professional therapy.\n\n- ❌ Not suitable for crisis intervention or severe relationship issues\n- ⚠️ Users should be informed of system limitations\n- 🔒 Privacy and data security are critical (sensitive relationship data)\n- ✅ All therapeutic models must be evidence-based\n\n## Acknowledgments\n\n- **Dan Koe** - [fix-life-in-1-day](https://github.com/evgyur/fix-life-in-1-day) skill architecture inspiration\n- **Dr. John Gottman** - Gottman Method framework\n- **Dr. Sue Johnson** - Emotionally Focused Therapy (EFT)\n- **Tavus AI** - Real-time avatar technology\n\n## License\n\nMIT License - See [LICENSE](LICENSE) for details\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Built with ❤️ for healthier relationships**\n\n[Report Bug](https://github.com/ziggythebot/couples-therapy-bot/issues) • [Request Feature](https://github.com/ziggythebot/couples-therapy-bot/issues) • [Discussions](https://github.com/ziggythebot/couples-therapy-bot/discussions)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fziggythebot%2Fcouples-therapy-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fziggythebot%2Fcouples-therapy-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fziggythebot%2Fcouples-therapy-bot/lists"}