Desktop agent for posture monitoring and ergonomic health.
Follow these steps to start using Posture Guardian:
- Go to the official website.
- Register for an account.
- Make sure to securely store your login credentials.
- Navigate to the Download page.
- Download the Windows application.
⚠️ Currently, the app is available for Windows only.- During installation, you may need to grant permissions (see the installation notes on the website for details).
- Install the application.
- After installation, locate the Posture Guardian icon.
- Launch the app.
- Enter your credentials.
- The application will:
- Activate your device camera.
- Start monitoring posture.
- Run in the background as a system tray application.
The application runs in the Windows system tray.
- Click the arrow-up (^) icon in the Windows taskbar (system tray).
- Find the Posture Guardian icon.
- Right-click the icon to access options:
- Stop Monitoring
- Settings
- Exit
To fully close the application, click Exit.
📊 All accumulated statistics will be available in your account on the website.
- Desktop Agent (C++): Lightweight system tray app
- ML Engine (Python/FastAPI): Posture classification
- Backend (Java/Spring Boot): User data & analytics API
- Frontend (React/TypeScript): Dashboard & insights
- Docker & Docker Compose
- Python 3.10+
- Java 21
- Node.js 21+
- CMake 3.20+ (for C++)
See README in each folder:
# Run services locally (each in separate terminal)
cd ml-engine && poetry run uvicorn main:app --reload
cd backend && mvn spring-boot:run
cd frontend && npm run dev- ML: MediaPipe, FastAPI, Redis
- Backend: Spring Boot 3, PostgreSQL, WebSocket
- Frontend: React, TypeScript, Vite, TailwindCSS
- Desktop: C++, ImGui, OpenCV
- DevOps: GitHub Actions, Docker