Skip to content

v0.4.0

Pre-release
Pre-release

Choose a tag to compare

@4rthurCai 4rthurCai released this 03 Feb 05:57

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-tmux

Documentation

Full Commit Changes: v0.1.0...v0.4.0

Full Changelog: CHANGELOG.md