{"id":40396330,"url":"https://github.com/alvinunreal/anxiety-aid-tools","last_synced_at":"2026-01-20T13:05:25.950Z","repository":{"id":309422113,"uuid":"1036234138","full_name":"alvinunreal/anxiety-aid-tools","owner":"alvinunreal","description":"Free open source tools to help you find calm when you need it most.","archived":false,"fork":false,"pushed_at":"2025-11-28T23:37:50.000Z","size":237666,"stargazers_count":227,"open_issues_count":2,"forks_count":22,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-11-29T07:41:25.298Z","etag":null,"topics":["anxiety","anxiety-helper","breathing","breathing-exercises","privacy-focused","self-help","self-help-tool"],"latest_commit_sha":null,"homepage":"https://anxietyaidtools.com","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alvinunreal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-08-11T19:01:59.000Z","updated_at":"2025-11-28T23:37:54.000Z","dependencies_parsed_at":"2025-09-23T20:18:38.617Z","dependency_job_id":"fd459bf2-66e8-4685-940c-d741d7b299c4","html_url":"https://github.com/alvinunreal/anxiety-aid-tools","commit_stats":null,"previous_names":["alvinunreal/anxiety-aid-tools"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/alvinunreal/anxiety-aid-tools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvinunreal%2Fanxiety-aid-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvinunreal%2Fanxiety-aid-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvinunreal%2Fanxiety-aid-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvinunreal%2Fanxiety-aid-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alvinunreal","download_url":"https://codeload.github.com/alvinunreal/anxiety-aid-tools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alvinunreal%2Fanxiety-aid-tools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28603426,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T12:01:53.233Z","status":"ssl_error","status_checked_at":"2026-01-20T12:01:46.545Z","response_time":117,"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":["anxiety","anxiety-helper","breathing","breathing-exercises","privacy-focused","self-help","self-help-tool"],"created_at":"2026-01-20T13:05:25.761Z","updated_at":"2026-01-20T13:05:25.935Z","avatar_url":"https://github.com/alvinunreal.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"public/aat.svg\" alt=\"Anxiety Aid Tools Logo\" width=\"200\" height=\"200\" /\u003e\n\n# Anxiety Aid Tools\n\n**Evidence-based techniques to find calm when you need it most**\n\n[![License: GPL](https://img.shields.io/badge/License-GPL-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n[![Multilingual Support](https://img.shields.io/badge/Languages-4-blue?logo=google-translate)](https://github.com/alvinunreal/anxiety-aid-tools)\n[![GitHub Stars](https://img.shields.io/github/stars/alvinunreal/anxiety-aid-tools?style=social)](https://github.com/alvinunreal/anxiety-aid-tools/stargazers)\n\n[**Website**](https://anxietyaidtools.com/) · [**Mobile Apps**](https://anxietyaidtools.com/mobile) · [**Community**](https://www.reddit.com/r/AnxietyAidTools/) · [**Contribute**](#contributing)\n\n*Transform anxious moments into opportunities for calm with scientifically-backed breathing exercises, grounding techniques, and mindfulness tools.*\n\n\u003c/div\u003e\n\n---\n\n## What Makes This Special\n\nA collection of anxiety management techniques built around four core principles.\n\n### 🚪 **No Barriers**\n- **No signup required** - Open the website and start immediately\n- **No ads** - Clean interface focused on what matters\n- **Works offline** - Available when you need it, regardless of connection\n- **Native mobile apps** - [iOS and Android apps](https://anxietyaidtools.com/mobile) for on-the-go access\n\n### 🔒 **Privacy First**\n- **Minimal analytics** - Privacy-focused Cloudflare Web Analytics only\n- **No personal tracking** - No cookies, fingerprinting, or personal data collection\n- **Local storage only** - All preferences saved on your device\n- **Aggregate data only** - Analytics are anonymized and aggregated\n\n### 🧬 **Open Source**\n- **Code is public** - Anyone can inspect, improve, or adapt it\n- **Community maintained** - Built by people who understand anxiety\n- **GPL licensed** - Free to use, modify, and redistribute\n\n### 🧠 **Science-Based**\n- **Research-backed techniques** - Methods studied in clinical settings\n- **Educational content** - Understanding why techniques work\n- **Evidence references** - Links to supporting research where available\n\n---\n\n## 🛠️ Interactive Techniques\n\n\u003cdiv align=\"center\"\u003e\n\n| 🫁 **Breathing** | ⚓ **Grounding** | 🧘 **Visualization** | 💭 **Mindfulness** |\n|:---:|:---:|:---:|:---:|\n| Guided breathing patterns | 5-4-3-2-1 sensory technique | Peaceful place imagery | Thought labeling |\n| 2-3 minutes | 3-5 minutes | 5-10 minutes | 5-10 minutes |\n\n\u003c/div\u003e\n\n### 🌟 **Featured Techniques**\n\n- **🫁 Breathing Exercises** - Interactive animations guide your breath rhythm\n- **⚓ 5-4-3-2-1 Grounding** - Sensory awareness to anchor you in the present\n- **🎯 Guided Breathing** - Customizable breath patterns with visual cues\n- **💪 Progressive Muscle Relaxation** - Release physical tension systematically\n- **🌅 Peaceful Visualization** - Immersive guided imagery sessions\n- **🧠 Thought Labeling** - Cognitive techniques to reframe anxious thoughts\n- **🫧 Stress Relief Bubbles** - Interactive bubble-popping for instant relief\n- **🌀 Online Fidget Spinner** - Minimal virtual spinner with realistic momentum for restless energy\n- **🎵 Sound Therapy** - Calming ambient soundscapes\n- **⚾ Virtual Stress Ball** - Tactile relief through digital interaction\n\n---\n\n## **Why Open Source Mental Health Matters**\n\n\u003e **\"Mental health tools should be accessible to everyone, everywhere, without barriers.\"**\n\n### **Our Mission**\n- **Remove barriers** to mental health support\n- **Democratize access** to evidence-based techniques\n- **Build trust** through transparency and community input\n- **Enable customization** for different cultures and needs\n\n### **Community Impact**\n- **Global reach** - No geographic restrictions\n- **Always free** - No premium features or paywalls\n- **Privacy respectful** - Minimal anonymized analytics to improve the service\n- **Community-driven** - Built by and for people who understand anxiety\n\n---\n\n## **Quick Start**\n\n### 🌐 Web \u0026 Mobile\n- **Web**: Visit [anxietyaidtools.com](https://anxietyaidtools.com/)\n- **Mobile Apps**: Download for [iOS or Android](https://anxietyaidtools.com/mobile)\n\n### 🐳 Docker (Self-Hosted)\n```bash\n# Quick run from Docker Hub\ndocker run -p 3000:3000 alvinunreal/anxiety-aid-tools:latest\n\n# Or build and run with Docker Compose\ngit clone https://github.com/alvinunreal/anxiety-aid-tools.git\ncd anxiety-aid-tools\ndocker compose up\n```\n\n### 💻 Local Development\n```bash\ngit clone https://github.com/alvinunreal/anxiety-aid-tools.git\ncd anxiety-aid-tools\npnpm install\npnpm run dev\n```\n\n## **For Contributors**\n```bash\n# Fork the repository\ngh repo fork alvinunreal/anxiety-aid-tools\n\n# Make your improvements\ngit checkout -b feature/your-improvement\n\n# Sync translations (if you modified text)\nnpm run sync-locales\n\n# Submit your contribution\ngh pr create\n```\n\n---\n\n### **Clinical Disclaimer**\nThis tool provides general anxiety management techniques and is not a substitute for professional mental health treatment. If you're experiencing persistent anxiety, please consult a healthcare provider.\n\n---\n\n## **Contributing**\n\nWe believe the best mental health tools are built by communities who understand the challenges firsthand.\n\n### **Ways to Help**\n- **Report bugs** - Help us improve reliability ([GitHub Issues](https://github.com/alvinunreal/anxiety-aid-tools/issues))\n- **Suggest features** - Share ideas for new techniques ([r/AnxietyAidTools](https://www.reddit.com/r/AnxietyAidTools/))\n- **Add translations** - Make it accessible to more people\n- **Improve content** - Enhance educational materials\n- **Design contributions** - Better UX for people in distress\n- **Share your story** - Help others by sharing how these tools helped you on [our subreddit](https://www.reddit.com/r/AnxietyAidTools/)\n\n### **Development Setup**\n```bash\n# Install dependencies\npnpm install\n\n# Start development server\npnpm dev\n\n# Run with HTTPS (for testing PWA features)\npnpm dev-https\n\n# Build for production\npnpm build\n\n# Check translations are in sync\npnpm sync-locales\n\n# Generate scene narration (see \"Peaceful Visualization Audio\" below)\npnpm generate:peaceful-visualization --lang en\n```\n\n### **Code Structure**\n```\nanxiety-aid-tools/\n├── components/          # Reusable Vue components\n│   ├── *Exercise.vue   # Interactive technique components\n│   └── TechniquesGrid.vue\n├── composables/        # Shared logic\n│   └── useTechniques.js # Technique data and utilities\n├── i18n/              # Internationalization\n│   └── locales/       # Translation files\n├── pages/             # Route components\n│   └── [technique].vue # Individual technique pages\n└── public/            # Static assets\n    └── aat.svg        # App logo\n```\n\n### **Peaceful Visualization Audio**\n\nWe generate the narration tracks with the ElevenLabs Text-to-Speech API.\n\n1. Create an API key at [ElevenLabs](https://elevenlabs.io/app/settings/api-keys) and expose it before running the generator:\n   ```bash\n   export ELEVENLABS_API_KEY=sk-your-key-here\n   ```\n   You can also place it in a `.env` file that your shell loads.\n2. Run the helper script from the project root:\n   ```bash\n   pnpm generate:peaceful-visualization --lang en\n   ```\n   - Choose a single scene when prompted, or pass `--scene all` to batch the whole exercise.\n   - Use `--overwrite` to re-generate clips that already exist, or `--dry-run` to preview without hitting the API.\n3. Generated audio files are written to `public/audios/peaceful-visualization/\u003clocale\u003e/\u003cscene\u003e/\u003cstep\u003e.mp3`.  \n   The Vue exercise automatically picks them up based on the current locale and scene.\n\nRepeat step 2 for each supported locale once you have suitable voices configured in ElevenLabs.\n\n---\n\n## **Asset Attribution**\n- **Illustrations** - Generated using ChatGPT\n- **Audio Narration** - Generated using ElevenLabs Text-to-Speech API\n\n---\n\n## **License**\n\nGPL License - feel free to use, modify, and distribute. Mental health tools should be open and accessible.\n\n### **Using Our Assets**\nAll assets in this project (illustrations, audio, etc.) are included under the same GPL v3 license as the code. You're welcome to use them in your own projects. **Attribution is appreciated** — if you use our assets, please credit Anxiety Aid Tools.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**If this project helped you, consider starring it to help others discover these techniques.**\n\n[**⭐ Star on GitHub**](https://github.com/alvinunreal/anxiety-aid-tools) • [**📱 Mobile Apps**](https://anxietyaidtools.com/mobile) • [**💬 r/AnxietyAidTools**](https://www.reddit.com/r/AnxietyAidTools/) • [**🐛 Report Issues**](https://github.com/alvinunreal/anxiety-aid-tools/issues)\n\n*Remember: You're stronger than your anxiety, and you're not alone in this journey.*\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falvinunreal%2Fanxiety-aid-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falvinunreal%2Fanxiety-aid-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falvinunreal%2Fanxiety-aid-tools/lists"}