{"id":30327340,"url":"https://github.com/parazeeknova/thermosense","last_synced_at":"2025-08-18T00:13:04.259Z","repository":{"id":307174753,"uuid":"1023817328","full_name":"parazeeknova/ThermoSense","owner":"parazeeknova","description":"Ambient-Aware Battery Health Advisor ","archived":false,"fork":false,"pushed_at":"2025-07-29T20:39:56.000Z","size":17914,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-29T21:58:36.590Z","etag":null,"topics":["ambient-temperature","battery-health","battery-life","gemini-api","internship-project","nextjs","systeminformation"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/parazeeknova.png","metadata":{"files":{"readme":".github/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}},"created_at":"2025-07-21T18:33:27.000Z","updated_at":"2025-07-29T20:39:59.000Z","dependencies_parsed_at":"2025-07-29T22:10:43.659Z","dependency_job_id":null,"html_url":"https://github.com/parazeeknova/ThermoSense","commit_stats":null,"previous_names":["parazeeknova/thermosense"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/parazeeknova/ThermoSense","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parazeeknova%2FThermoSense","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parazeeknova%2FThermoSense/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parazeeknova%2FThermoSense/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parazeeknova%2FThermoSense/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/parazeeknova","download_url":"https://codeload.github.com/parazeeknova/ThermoSense/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parazeeknova%2FThermoSense/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270924178,"owners_count":24668690,"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","status":"online","status_checked_at":"2025-08-17T02:00:09.016Z","response_time":129,"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":["ambient-temperature","battery-health","battery-life","gemini-api","internship-project","nextjs","systeminformation"],"created_at":"2025-08-18T00:13:03.677Z","updated_at":"2025-08-18T00:13:04.242Z","avatar_url":"https://github.com/parazeeknova.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003e [!NOTE]\n\u003e This project was developed as part of an internship task, I won't be maintaining it actively. Feel free to fork and contribute!\n\n\u003e [!WARNING]\n\u003e This project contains a nextjs app with a electron wrapper (pretty janky setup ik) but it works. The app is not meant to be run in production. Also the build files does not work properly, so you will have to run the app in development mode. The app is not meant to be run in production. Also the build files does not work properly, so you will have to run the app in development mode.\n\n\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"./assets/thermosense.png\" alt=\"thermosense-banner\" width=\"100%\"\u003e\n\n\u003c/div\u003e\n\n---\n\n[![Next.js](https://img.shields.io/badge/Next.js-15.4.2-EBE9DF?style=for-the-badge\u0026logo=next.js\u0026logoColor=EBE9DF)](https://nextjs.org/)\n[![React](https://img.shields.io/badge/React-19.1.0-EBE9DF?style=for-the-badge\u0026logo=react\u0026logoColor=EBE9DF)](https://reactjs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.8.3-EBE9DF?style=for-the-badge\u0026logo=typescript\u0026logoColor=EBE9DF)](https://www.typescriptlang.org/)\n[![TailwindCSS](https://img.shields.io/badge/TailwindCSS-4.1.11-EBE9DF?style=for-the-badge\u0026logo=tailwindcss\u0026logoColor=EBE9DF)](https://tailwindcss.com/)\n[![Docker](https://img.shields.io/badge/Docker-Ready-EBE9DF?style=for-the-badge\u0026logo=docker\u0026logoColor=EBE9DF)](https://www.docker.com/)\n[![Self-Hostable](https://img.shields.io/badge/Self--Hostable-✓-EBE9DF?style=for-the-badge\u0026logo=homeassistant\u0026logoColor=EBE9DF)](https://github.com)\n\n\u003e An intelligent thermal management system that helps users understand how ambient weather affects their device's thermal state, predict overheating risks, and take preventive actions through AI-powered insights built with electron.\n\n## Project Overview\n\nThermoSense is **ambient-aware battery health advisor** that bridges the gap between environmental conditions and device thermal management. The application provides real-time monitoring, predictive analytics, and AI-powered recommendations to optimize device performance and battery longevity.\n\n## Features\n\n- **Real-Time Device Monitoring:**\n  Continuously tracks CPU temperature, battery status, and system load, updating every 2 seconds for instant feedback.\n- **Ambient-Aware Analytics:**\n  Integrates live weather data to correlate environmental conditions with device thermal state.\n- **Advanced Heat Risk Assessment:**\n  Uses a weighted scoring algorithm to evaluate overheating risk, factoring in device and ambient temperatures, CPU load, humidity, and time of day.\n- **AI-Powered Recommendations:**\n  Leverages Google Gemini AI to provide actionable, context-aware tips for thermal management, battery health, and performance optimization.\n- **Predictive Analytics:**\n  Forecasts future device temperature trends and risk levels, helping users take proactive measures.\n- **Customizable Dashboard:**\n  Modular, drag-and-drop interface lets users personalize their monitoring and analytics layout.\n- **Historical Data Visualization:**\n  Displays trends and patterns over time, enabling users to analyze past device performance and environmental impacts.\n- **Notification Center:**\n  Centralized hub for AI recommendations, alerts, and actionable insights.\n- **Responsive \u0026 Modern UI:**\n  Built with React, Next.js, and Tailwind CSS for a seamless experience across devices.\n- **Electron Wrapper:**\n  Provides a desktop application experience with system-level access for real-time monitoring and notifications.\n- **Many more features...**\n\n## Setup \u0026 Installation\n\n### Environment Variables - Required for AI \u0026 Weather (Can be configured in the app itself)\n\nCreate a `.env.local` file in the root directory:\n\n```bash\n# Required for AI features\nGEMINI_API_KEY=your_google_gemini_api_key_here\n# Required for weather data\nNEXT_PUBLIC_OPENWEATHER_API_KEY=your_openweather_api_key_here\n```\n### Running in development mode\n```bash\n# (to build the nextjs app)\nnpm run build\n# (to build the electron app)\nnpm run build:electron\n# (to run the app)\nnpm run electron:dev\n```\n\n## Screenshots (old)\n\n|          Dashboard Overview          |              Analytics               |                 More Analytics                 |           Draggable Cards            |\n| :----------------------------------: | :----------------------------------: | :--------------------------------------------: | :----------------------------------: |\n| ![Dashboard](./assets/dashboard.png) | ![Analytics](./assets/analytics.png) | ![Analytics More](./assets/analytics-more.png) | ![Draggable](./assets/draggable.png) |\n\n---\n\n**Built with ❤️ for Thermal Intelligence**\n\n_Developed as part of internship application for UI/UX Design Engineer Position - showcasing web development, AI integration, and system programming capabilities._\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparazeeknova%2Fthermosense","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparazeeknova%2Fthermosense","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparazeeknova%2Fthermosense/lists"}