Skip to content

๐Ÿข AI-powered desktop app for real-time posture correction - detects forward head posture via webcam and sends smart notifications to improve your sitting habits

License

Notifications You must be signed in to change notification settings

zhangnew/pose-nudge

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

73 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Pose Nudge

Pose Nudge Logo
AI-Powered Posture Correction Assistant - Real-time Posture Analysis and Improvement Guide

GitHub Stars GitHub Forks All Contributors
GitHub Release GitHub Downloads License
Build Status GitHub Issues GitHub Pull Requests

Language-English Language-Korean


โœจ Key Features

Pose Nudge is a powerful desktop application that uses your webcam to analyze posture in real-time and sends notifications when posture issues like forward head posture are detected, helping you maintain proper posture.

  • ๐Ÿ“น Real-time Posture Analysis: Webcam-based real-time posture monitoring and AI-powered analysis
  • ๐Ÿฆด Forward Head Posture Detection: Calculates neck and shoulder line angles to detect forward head posture
  • ๐Ÿ”” Smart Notifications: Browser notifications and improvement recommendations when posture issues are detected
  • ๐Ÿ“Š Posture Score: Displays current posture status scored from 0-100 points
  • ๐Ÿ“ˆ Statistics Dashboard: View posture improvement progress and session records
  • โš™๏ธ Personalized Settings: Customizable notification intervals, sensitivity, and analysis frequency

๐ŸŽฅ Demo

Screenshots

แ„‰แ…ณแ„แ…ณแ„…แ…ตแ†ซแ„‰แ…ฃแ†บ 2025-09-05 แ„‹แ…ฉแ„’แ…ฎ 5 02 27 แ„‰แ…ณแ„แ…ณแ„…แ…ตแ†ซแ„‰แ…ฃแ†บ 2025-09-05 แ„‹แ…ฉแ„’แ…ฎ 5 03 50 แ„‰แ…ณแ„แ…ณแ„…แ…ตแ†ซแ„‰แ…ฃแ†บ 2025-09-05 แ„‹แ…ฉแ„’แ…ฎ 5 17 18

Demo GIF

Demo GIF


๐Ÿ“ฅ Download

Download the latest version of Pose Nudge for your operating system.

Operating System File Format Download Link
๐Ÿ’ป Windows .exe
๐Ÿ macOS .dmg
๐Ÿง Linux .AppImage

๐Ÿ‘จโ€๐Ÿ’ป For Developers

If you're interested in contributing, follow this guide to set up the project locally.

Prerequisites

Installation & Run

# 1. Clone the project
git clone https://github.com/dduldduck/pose-nudge.git
cd pose-nudge

# 2. Install Node.js dependencies
npm install

# 3. Run in development mode
npm run tauri dev

Project Structure

pose-nudge/
โ”œโ”€โ”€ src/                    # React Frontend
โ”‚   โ”œโ”€โ”€ components/         # UI Components
โ”‚   โ”‚   โ”œโ”€โ”€ ui/            # shadcn/ui Components
โ”‚   โ”‚   โ”œโ”€โ”€ Dashboard.tsx   # Dashboard
โ”‚   โ”‚   โ”œโ”€โ”€ WebcamCapture.tsx # Webcam Component
โ”‚   โ”‚   โ””โ”€โ”€ SettingsPage.tsx # Settings Page
โ”‚   โ”œโ”€โ”€ lib/               # Utility Functions
โ”‚   โ”œโ”€โ”€ locales/           # Internationalization Support
โ”‚   โ””โ”€โ”€ App.tsx            # Main App Component
โ”œโ”€โ”€ src-tauri/             # Rust Backend
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ main.rs        # Main Backend Logic
โ”‚   โ”‚   โ”œโ”€โ”€ pose_analysis.rs # Posture Analysis Engine
โ”‚   โ”‚   โ””โ”€โ”€ notifications.rs # Notification System
โ”‚   โ”œโ”€โ”€ Cargo.toml         # Rust Dependencies
โ”‚   โ””โ”€โ”€ tauri.conf.json    # Tauri Configuration
โ”œโ”€โ”€ models/                # AI Model Files
โ”œโ”€โ”€ public/                # Static Files
โ””โ”€โ”€ locales/               # Localization Files

๐Ÿ› ๏ธ Tech Stack

  • Framework: Tauri (Rust + React)
  • Frontend: React 19, TypeScript, Tailwind CSS 4
  • Backend: Rust, Tauri 2
  • AI/ML: YOLO-Pose Model (planned for future integration)
  • Build/Deployment: Tauri CLI

๐Ÿค Contributing

Contributions are always welcome! Whether it's bug reports, feature suggestions, or code contributions, we welcome all forms of participation. Please check out our Contributing Guidelines for more details.


โœจ Contributors

Thanks to these wonderful people who have made this project better! (emoji key)

Jaeseok Song
Jaeseok Song

๐Ÿ’ป ๐Ÿšง
Adam Dangoor
Adam Dangoor

๐Ÿ›
Yodoma
Yodoma

๐Ÿ›
Add your contributions

๐Ÿ“œ License

This project is licensed under the AGPLv3 License.

Contributors โœจ

Thanks goes to these wonderful people (emoji key):

This project follows the all-contributors specification. Contributions of any kind welcome!

About

๐Ÿข AI-powered desktop app for real-time posture correction - detects forward head posture via webcam and sends smart notifications to improve your sitting habits

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 55.7%
  • Rust 41.4%
  • CSS 2.7%
  • HTML 0.2%