Your AI-Powered Desk Wellness Companion

🔗 View on DevPost | 📊 Presentation

3AM at hackathons. Endless office hours. Study marathons.

Millions of people spend hours glued to screens, developing "tech neck," stiffness, and fatigue. Traditional solutions? Awkward yoga poses in public spaces or forgetting to stretch entirely.

Deskercise.AI transforms your workspace into a wellness station with AI-powered stretch coaching that actually works for real environments.

"Hour 28 of our hackathon — the rest of the venue looked like a caffeine-fueled zombie apocalypse. Meanwhile, our team was doing shoulder rolls guided by our own AI coach every Pomodoro break. While others crashed at 3AM, we were still sharp, energized, and coding clean. We didn't just build Deskercise; we lived it, and it literally saved our hackathon."

-- The Deskercise.AI Team, UC Berkeley AI Hackathon 2025

• Pomodoro timer with intelligent stretch recommendations
• Automatic session tracking and analytics
• Calendar integration for meeting break reminders

• Real-time pose detection using MediaPipe
• Voice-powered guidance with conversational AI
• Live form correction and personalized feedback
• Progress tracking with XP and streaks

• Exercises designed for office/study environments
• No awkward poses or equipment needed
• Webcam-based monitoring with privacy-first approach

# Clone and install
git clone https://github.com/yourusername/deskercise.git
cd deskercise
npm install

# Set up environment variables
cp sample.env .env
# Edit .env with your actual API keys (see API Setup section below)

# Start development server
npm start

Requirements:

• Node.js 14+
• Modern browser with webcam
• API keys for Google Calendar, Gemini AI, and Vapi Voice AI

Deskercise requires several API keys to function properly. Follow these steps to get your keys:

1. Go to Google Cloud Console
2. Create a new project or select existing one
3. Enable the following APIs:
   • Google Calendar API
   • Google+ API
4. Create OAuth 2.0 credentials for REACT_APP_GOOGLE_CLIENT_ID
5. Create API key for REACT_APP_GOOGLE_API_KEY

1. Visit Google AI Studio
2. Create a new API key
3. Add it as REACT_APP_GEMINI_API_KEY

1. Sign up at Vapi.ai
2. Create a new assistant
3. Get your API key and assistant ID
4. Add them as REACT_APP_VAPI_API_KEY and REACT_APP_VAPI_ASSISTANT_ID

Copy sample.env to .env and replace the placeholder values:

cp sample.env .env

Then edit .env with your actual API keys:

REACT_APP_GOOGLE_CLIENT_ID=your_actual_google_client_id
REACT_APP_GOOGLE_API_KEY=your_actual_google_api_key
REACT_APP_GEMINI_API_KEY=your_actual_gemini_api_key
REACT_APP_VAPI_API_KEY=your_actual_vapi_api_key
REACT_APP_VAPI_ASSISTANT_ID=your_actual_vapi_assistant_id

Note: Never commit your .env file to version control. It's already included in .gitignore.

1. Set Your Focus Time - Start a Pomodoro session
2. Get Smart Reminders - AI suggests stretch breaks at optimal times
3. Follow AI Guidance - Voice coach walks you through exercises
4. Perfect Your Form - Real-time pose analysis ensures proper technique
5. Track Progress - Build streaks and improve your wellness metrics

MediaPipe Pose → Pose Analysis → Unify Coordinator
     ↓                              ↓
Webcam Feed ←→ Real-time Feedback ←→ Vapi Voice Coach
                                    ↓
                              Gemini LLM (Context)

Smart Agents:

• HoldTrackerAgent: Monitors pose duration and quality
• FeedbackAgent: Generates contextual improvement suggestions
• VoiceCoachAgent: Provides natural language guidance
• XPTrackerAgent: Gamifies progress with streaks and achievements
• PlannerAgent: Selects optimal exercises based on user history

• Reduce healthcare costs from repetitive strain injuries
• Boost employee productivity and satisfaction
• Seamless integration with existing workflows

• Combat "Zoom fatigue" in remote learning
• Promote healthy study habits
• Scalable solution for student wellness programs

• Prevent long-term posture-related health issues
• Gamified approach increases engagement
• Privacy-focused design builds trust

• Multilingual voice coaching with cultural adaptation
• Predictive wellness analytics to prevent strain before it occurs
• Eye tracking integration for comprehensive fatigue detection
• Smart calendar analysis for optimal break scheduling
• Advanced pose tracking analysis for better tracking.
• More Real-time AI coach assistance with dynamic workout adjustments

• Mobile companion app
• Team challenges and corporate dashboards
• Wearable device integration
• VR/AR stretch environments

🥇 CalHacks AI 2025 - Best AI Tool

Built in 36 hours, Deskercise represents the future of workplace wellness through intelligent, accessible, and engaging technology.

Ready to transform workplace wellness?

• 🌐 Demo: DevPost Submission
• 📧 Contact: Connect with our team on LinkedIn
• 🤝 Partnerships: Open to corporate pilots and educational collaborations