{"id":50726068,"url":"https://github.com/hess125/final_project","last_synced_at":"2026-06-10T04:30:27.798Z","repository":{"id":359170220,"uuid":"1215905750","full_name":"hess125/final_project","owner":"hess125","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-28T10:47:00.000Z","size":1587,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-28T11:16:06.033Z","etag":null,"topics":["artificial-intelligence","lstm-autoencoder","machine-learning","monitoring-tool","mouse-tracking","python","raspberry-pi","stress-detection"],"latest_commit_sha":null,"homepage":"https://final-project-msxv.onrender.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hess125.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-20T11:20:41.000Z","updated_at":"2026-05-28T10:47:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hess125/final_project","commit_stats":null,"previous_names":["hess125/final_project"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/hess125/final_project","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hess125%2Ffinal_project","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hess125%2Ffinal_project/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hess125%2Ffinal_project/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hess125%2Ffinal_project/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hess125","download_url":"https://codeload.github.com/hess125/final_project/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hess125%2Ffinal_project/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34137570,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["artificial-intelligence","lstm-autoencoder","machine-learning","monitoring-tool","mouse-tracking","python","raspberry-pi","stress-detection"],"created_at":"2026-06-10T04:30:27.309Z","updated_at":"2026-06-10T04:30:27.792Z","avatar_url":"https://github.com/hess125.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CogHealth Monitor\n\n[https://hess125.github.io/final_project/]    *Project documentation website*\n\n[https://final-project-msxv.onrender.com/]  *This is a deployed version of the system for viewers to see what it is like before installation*\n\n“It’s not stress that kills us; it is our reaction to it.” – Hans Selye\n\n## Introduction\n\nCogHealth is an innovative, real-time behavioral stress monitoring system designed to provide users with insights into their cognitive well-being through passive analysis of keyboard and mouse interactions. This system was inspired by growing concerns surrounding citizen surveillance and the series *Psycho-Pass* which served an interesting lesson on how behavioral monitoring, even when intended for public safety, can become a tool for oppression, manipulation, and loss of individual autonomy. \n\nModern society is increasingly reliant on data collection systems that track user behavior—from keystroke dynamics to mouse movements—often without meaningful transparency or consent. While such data can offer valuable insights into cognitive well-being, it raises critical questions about privacy, autonomy, and the potential for abuse.\n\nCogHealth takes a fundamentally different approach: **empowering individuals rather than surveilling them**. Rather than collecting data for external oversight or control, CogHealth puts the user in command of their own cognitive health insights. The system:\n\n### Key Features:\n\n*   **Real-time Stress Visualization**: A dynamic 3D visualization that intuitively reflects current stress levels.\n    *   **Calm State**: At low stress, a serene **3D Leaf** gently sways, symbolizing focus and tranquility.\n    *   **Stressed State**: As stress elevates, the visualization transforms into a **rapidly stretching ball**, indicating heightened cognitive load.\n*   **Behavioral Feature Extraction**: Analyzes typing speed, keystroke dynamics, error rates, mouse movements, and more to infer stress.\n*   **Self-Report Integration**: Allows users to log their perceived stress, providing valuable ground truth for correlation.\n\n## Directory Structure\n\n```\n. \n├── README.md\n├── AssessmentSubmissions\n│   ├── Figures/\n│   ├── Forms/\n|   ├── ProjectTimelines/\n|   ├── Tables/\n|   ├── Wireframes/\n|   ├── Project A1_32146983.pdf\n|   ├── ProjectReportA2_32146983HessaK_Batch2.pdf\n│   └── ProjectPosterA3_32146983HessaK_Batch2.pdf\n|\n├── check_env.py\n├── collector.py\n├── config.py\n├── data/\n│   ├── features/\n│   ├── raw/\n│   └── self_reports.db\n|\n├── evaluation.py\n├── features.py\n├── led.py\n├── logs/\n│   └── coghealth.log\n├── model.py\n├── models/\n│   ├── autoencoder.h5\n│   ├── autoencoder.tflite\n│   ├── scaler.pkl\n│   └── threshold.json\n|\n├── orchestrator.py\n├── requirements.txt\n├── run.py\n├── server.py\n├── setup.sh\n├── tests/\n└── web/\n\n```\n\n## Installation\n\nTo set up the CogHealth Monitor locally, follow these steps:\n\n1.  **Clone the repository**:\n    ```bash\n    git clone https://github.com/hess125/final_project.git\n    cd final_project\n    ```\n\n2.  **Create a virtual environment** (recommended):\n    ```bash\n    python3 -m venv venv\n    source venv/bin/activate\n    ```\n\n3.  **Install dependencies**:\n    ```bash\n    pip install -r requirements.txt\n    ```\n\n*To run the full system with local keyboard/mouse monitoring (requires `pynput`):*\n\n4.  Ensure `pynput` is installed (`pip install pynput`).\n\n5.  Run the orchestrator:\n    ```bash\n    python3 run.py\n    ```\n6.  Open your web browser and navigate to `http://localhost:5000`.\n\nOnce deployed, the web application will be accessible via the URL provided by Render, offering a live, browser-based stress monitoring experience.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhess125%2Ffinal_project","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhess125%2Ffinal_project","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhess125%2Ffinal_project/lists"}