{"id":18249316,"url":"https://github.com/rsemihkoca/postrue","last_synced_at":"2026-05-02T11:34:38.395Z","repository":{"id":193747631,"uuid":"689404763","full_name":"rsemihkoca/Postrue","owner":"rsemihkoca","description":"Postrue is a Python-based application that empowers users to enhance their posture in real-time by detecting and correcting incorrect postures using Mediapipe and OpenCV libraries. ","archived":false,"fork":false,"pushed_at":"2023-09-21T13:20:17.000Z","size":3627,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-14T15:49:56.171Z","etag":null,"topics":["computer-vision","mediapipe","opencv","pose","pose-detection","posture","posture-recognition","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rsemihkoca.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-09T17:41:57.000Z","updated_at":"2024-07-07T14:58:13.000Z","dependencies_parsed_at":"2024-11-05T09:52:38.095Z","dependency_job_id":null,"html_url":"https://github.com/rsemihkoca/Postrue","commit_stats":null,"previous_names":["rsemihkoca/postrue"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsemihkoca%2FPostrue","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsemihkoca%2FPostrue/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsemihkoca%2FPostrue/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsemihkoca%2FPostrue/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rsemihkoca","download_url":"https://codeload.github.com/rsemihkoca/Postrue/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247919042,"owners_count":21018050,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["computer-vision","mediapipe","opencv","pose","pose-detection","posture","posture-recognition","python"],"created_at":"2024-11-05T09:39:44.753Z","updated_at":"2026-05-02T11:34:38.331Z","avatar_url":"https://github.com/rsemihkoca.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Postrue: Correcting Body Posture and Data Collection\n\nPostrue is a Python-based application that helps users improve their body posture by providing real-time feedback and warnings about incorrect postures. Additionally, it collects valuable posture data for further analysis, which is stored in a PostgreSQL database.\n\n## Features\n- **Real-time Posture Correction**: Postrue utilizes the Mediapipe and OpenCV libraries to detect the user's body posture in real-time. It provides warnings and guidance to help users maintain correct postures.\n\n- **Data Collection**: The application offers three different data retrieval endpoints: `GET /daily/`, `GET /weekly/`, and `GET /monthly/`. Users can access their posture data on a daily, weekly, or monthly basis, allowing them to track their progress over time.\n\n- **Database Storage**: All collected posture data is securely stored in a PostgreSQL database, ensuring that users can review their historical posture information and gain insights into their posture improvement journey.\n\n## Technology Stack\n- **Language**: Python\n- **Libraries**: \n  - Mediapipe and OpenCV for real-time posture detection.\n  - FastAPI for creating the API endpoints.\n  - SQLAlchemy for interacting with the PostgreSQL database.\n\n## Live Demo\nCheck out the live demo of Postrue in action: [Watch Demo](https://www.youtube.com/watch?v=PwMzpxKCctk\u0026ab_channel=R%C4%B1zaSemihKoca)\n\n## Screenshots\n![Screenshot 1](backend%2Fassets%2F4.jpg)\n![Screenshot 2](backend%2Fassets%2Fcbimage.png)\n\n![Screenshot 3](backend%2Fassets%2F1.jpg)\n![Screenshot 4](backend%2Fassets%2Fresultgood.png)\n![Screenshot 5](backend%2Fassets%2F65cde025.png)\n\n## Getting Started\nTo set up and run docker-compose, follow these steps:\n1. Clone the repository.\n2. Create a `.env` file in the `backend` directory and add the following environment variables(Values can be changed as needed):\n```\nPOSTGRES_USER=postgres\nPOSTGRES_PASSWORD=postgres\nPOSTGRES_DATABASE=postgres\nPOSTGRES_HOST=127.0.0.1\nPOSTGRESQL_CON_STR=postgresql+psycopg2://postgres:postgres@127.0.0.1:5432/postgres\nPGADMIN_DEFAULT_EMAIL=admin@admin.com\nPGADMIN_DEFAULT_PASSWORD=admin\n```\n3. Run `docker-compose up --build` to build the images and start the containers.\n4. Navigate to `http://localhost:8000/docs` to access the Swagger UI and test the API endpoints.\n5. Navigate to `http://localhost:8081` to access the pgAdmin dashboard and view the database.\n\n## Usage\n1. Start the application and allow access to your camera for real-time posture detection.\n2. Maintain correct posture, and Postrue will provide feedback and warnings if any incorrect postures are detected.\n3. Use the data retrieval endpoints (`GET /daily/`, `GET /weekly/`, and `GET /monthly/`) to track your posture improvement progress.\n\n## Contribution\nWe welcome contributions from the open-source community to make Postrue even better. Feel free to create issues, submit pull requests, or provide feedback.\n\n## License\nThis project is licensed under the [MIT License](LICENSE).\n\n## Acknowledgments\n- Special thanks to \n- @rabiaelifcelik for the logo design.\n- @bunyaminkorkut for the analytics design and application.\n- @feyyum for the frontend application.\n\n\nImprove your posture with Postrue, and start your journey towards better health and well-being!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frsemihkoca%2Fpostrue","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frsemihkoca%2Fpostrue","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frsemihkoca%2Fpostrue/lists"}