Wellness Companion

AI-driven mental health and wellness assistant with conversational AI, voice cloning, avatar mirroring, mood analytics, and coping strategies.

Tech Stack

• Frontend: React (Vite) + TailwindCSS, Redux Toolkit, Plotly.js, WebRTC, Ready Player Me, Firebase Auth
• Backend: FastAPI, Transformers, Coqui TTS, ChromaDB, PostgreSQL, MongoDB, WebSockets, AWS S3
• Deployment: Docker, Docker Compose, Vercel/Netlify (frontend), AWS EC2 (backend)

Monorepo Structure

Wellness-Companion/
  backend/
  frontend/
  docker-compose.yml
  docs/

Quickstart (Local)

1. Copy env template

cp backend/.env.example backend/.env

2. Build and run backend stack

docker compose up -d --build

Backend API at http://localhost:8000/docs

3. Run frontend (dev)

cd frontend
npm install
npm run dev

Frontend at http://localhost:5173

Backend

• Framework: FastAPI at backend/main.py
• Routers: backend/app/routers/
• Models/Engines: backend/app/models/
• DB: backend/app/db/
• Utils: backend/app/utils/

Run without Docker:

python -m venv .venv
. .venv/Scripts/activate
pip install -r backend/requirements.txt
uvicorn backend.main:app --reload --host 0.0.0.0 --port 8000

Frontend

• Vite React app in frontend/
• Tailwind configured. Redux store in frontend/src/store/

Deployment

• Backend: build backend/Dockerfile and deploy to AWS EC2.
• Frontend: deploy to Vercel/Netlify.

VS Code Integration

Full Docker + VS Code integration configured:

• Docker sidebar management
• Pre-configured tasks (Ctrl+Shift+B)
• Debug configurations (F5)
• Recommended extensions
• Quick Start: See QUICK_START_VSCODE.md
• Full Guide: See VSCODE_SETUP.md

Safety

• No diagnosis. No crisis handling. Provide supportive, factual, safe content.

License

MIT