v0.1.0
Pre-release
Pre-release
MomShell v0.1.0
The first 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
Tech Stack
- Backend: FastAPI, MediaPipe, LangGraph, Edge TTS, SQLite
- 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 separate terminalsDocumentation
- README - Project overview and setup
- Contributing Guide - Development standards and workflow