v0.4.0
Pre-release
Pre-release
MomShell v0.4.0
The second public release of MomShell — a warm, AI-powered companion for postpartum recovery.
Highlights
Soulful Companion
AI-powered emotional support chat companion with warm, validating conversations designed specifically for postpartum mothers. Powered by ModelScope Qwen with visual ambient effects and conversation memory.
Community
Mutual support community featuring:
- Dual-channel system: Professional Channel (doctors' advice) & Experience Channel (moms' stories)
- Verified healthcare professionals with visual badges
- Q&A with likes, collections, and content moderation
- Daily Resonance topics and Shell Picks collections
Recovery Coach
AI-powered postpartum exercise coaching with:
- Real-time pose detection (MediaPipe, 33 body landmarks)
- 9 postpartum-specific exercises across 5 categories
- LLM-powered voice feedback with Edge TTS
- Progress tracking with achievements and streaks
- Safety monitoring with fatigue detection
Guardian Partner
Gamified system to engage partners in postpartum recovery with:
- Partner binding via invite codes
- Daily status recording (mood, energy, health conditions, feeding, sleep)
- Smart suggestions pushed to partner based on mom's status
- Task system with 3 difficulty levels and point rewards
- Level progression: Intern → Trainee → Regular → Gold
- Time recorder for baby milestone photos
Tech Stack
- Backend: FastAPI, MediaPipe, LangGraph, Edge TTS, SQLite + SQLAlchemy
- Frontend: Next.js 16, React 19, TypeScript, Tailwind CSS 4, Framer Motion
Deployment
- Docker Compose (multi-container with nginx)
- Single container deployment (ModelScope compatible)
- Local development with hot reload
Quick Start
# Clone and configure
git clone https://github.com/koishi510/MomShell.git
cd MomShell
cp .env.example .env # Add your MODELSCOPE_KEY
# Docker (recommended)
docker compose up -d --build
# Access at http://localhost:7860
# Or local development
uv sync
cd frontend && npm install && cd ..
# Run backend and frontend in your terminal
# We recommend you to use tmux
make dev-tmuxDocumentation
- README - Project overview and setup
- Contributing Guide - Development standards and workflow
Full Commit Changes: v0.1.0...v0.4.0
Full Changelog: CHANGELOG.md