{"id":31798250,"url":"https://github.com/mujhtech/ai_energy_assistant","last_synced_at":"2026-04-15T21:31:10.923Z","repository":{"id":318635592,"uuid":"1072108193","full_name":"Mujhtech/ai_energy_assistant","owner":"Mujhtech","description":"An intelligent Home Assistant integration that uses AI to analyze your solar energy system data and provide insights and predictions for your energy usage.","archived":false,"fork":false,"pushed_at":"2025-10-08T09:31:39.000Z","size":7,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-08T11:34:13.151Z","etag":null,"topics":["ai","energy-management","hacs","home-assistant","integration"],"latest_commit_sha":null,"homepage":"","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/Mujhtech.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":"2025-10-08T09:16:26.000Z","updated_at":"2025-10-08T09:31:42.000Z","dependencies_parsed_at":"2025-10-08T11:34:17.225Z","dependency_job_id":"3bbc3c61-6e49-44c7-bb8f-2631390d0694","html_url":"https://github.com/Mujhtech/ai_energy_assistant","commit_stats":null,"previous_names":["mujhtech/ai_energy_assistant"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Mujhtech/ai_energy_assistant","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mujhtech%2Fai_energy_assistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mujhtech%2Fai_energy_assistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mujhtech%2Fai_energy_assistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mujhtech%2Fai_energy_assistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mujhtech","download_url":"https://codeload.github.com/Mujhtech/ai_energy_assistant/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mujhtech%2Fai_energy_assistant/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279005410,"owners_count":26083883,"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-10-10T02:00:06.843Z","response_time":62,"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":["ai","energy-management","hacs","home-assistant","integration"],"created_at":"2025-10-10T21:16:25.438Z","updated_at":"2025-10-10T21:16:30.663Z","avatar_url":"https://github.com/Mujhtech.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI Energy Assistant\n\n[![hacs_badge](https://img.shields.io/badge/HACS-Custom-orange.svg)](https://github.com/custom-components/hacs)\n\nAn intelligent Home Assistant integration that uses AI to analyze your solar energy system data and provide insights and predictions for your energy usage.\n\n## Features\n\n- 🤖 AI-powered energy analysis using OpenAI or Google Gemini\n- ☀️ Solar energy monitoring and predictions\n- 🔋 Battery state of charge tracking\n- 📊 Daily energy usage insights\n- 🔮 Next-day energy predictions\n- ⚡ Automatic hourly updates\n\n## Supported AI Providers\n\n- **OpenAI** (GPT-4o-mini)\n- **Google Gemini** (Gemini Pro)\n\n## Installation\n\n### HACS Installation (Recommended)\n\n1. Open HACS in your Home Assistant instance\n2. Click on \"Integrations\"\n3. Click the three dots in the top right corner\n4. Select \"Custom repositories\"\n5. Add `https://github.com/mujhtech/ai_energy_assistant` as a custom repository\n6. Select \"Integration\" as the category\n7. Click \"Add\"\n8. Search for \"AI Energy Assistant\" and install\n\n### Manual Installation\n\n1. Copy the `custom_components/ai_energy_assistant` folder to your Home Assistant's `custom_components` directory\n2. Restart Home Assistant\n3. Go to Configuration → Integrations\n4. Click \"+ Add Integration\"\n5. Search for \"AI Energy Assistant\"\n\n## Configuration\n\n1. Select your AI provider (OpenAI or Gemini)\n2. Enter your API key:\n   - For OpenAI: Get your API key from [OpenAI Platform](https://platform.openai.com/api-keys)\n   - For Gemini: Get your API key from [Google AI Studio](https://makersuite.google.com/app/apikey)\n\n## Usage\n\nOnce configured, the integration creates a sensor entity:\n\n- `sensor.ai_energy_prediction` - Displays AI-generated analysis and predictions\n\n### Example Dashboard Cards\n\n#### Simple Summary Card (Mushroom)\n\n```yaml\ntype: custom:mushroom-template-card\nentity: sensor.ai_energy_prediction\nprimary: AI Energy Assistant\nsecondary: \"{{ states('sensor.ai_energy_prediction') }}\"\nicon: mdi:solar-power\nicon_color: orange\nmultiline_secondary: true\n```\n\n#### Detailed Analysis Card\n\n```yaml\ntype: markdown\ncontent: |\n  ## 🌞 AI Energy Assistant\n\n  **Summary:** {{ states('sensor.ai_energy_prediction') }}\n\n  ### 📊 Today's Performance\n  {{ state_attr('sensor.ai_energy_prediction', 'today_performance') }}\n\n  ### 📈 Trends\n  {{ state_attr('sensor.ai_energy_prediction', 'trends') }}\n\n  ### 🔮 Tomorrow's Prediction\n  {{ state_attr('sensor.ai_energy_prediction', 'tomorrow_prediction') }}\n  *Confidence: {{ state_attr('sensor.ai_energy_prediction', 'confidence') }}*\n\n  ### 💡 Recommendation\n  {{ state_attr('sensor.ai_energy_prediction', 'recommendation') }}\n```\n\n#### Advanced: Multiple Cards\n\n```yaml\ntype: vertical-stack\ncards:\n  - type: custom:mushroom-template-card\n    entity: sensor.ai_energy_prediction\n    primary: Energy Summary\n    secondary: \"{{ states('sensor.ai_energy_prediction') }}\"\n    icon: mdi:solar-power\n    icon_color: orange\n\n  - type: markdown\n    content: |\n      **Tomorrow:** {{ state_attr('sensor.ai_energy_prediction', 'tomorrow_prediction') }}\n\n      **💡 Tip:** {{ state_attr('sensor.ai_energy_prediction', 'recommendation') }}\n```\n\n### Available Attributes\n\nThe sensor provides the following attributes:\n\n- `summary` - Brief overview (displayed as sensor state, max 250 chars)\n- `today_performance` - Analysis of today's performance vs. past week\n- `trends` - Key trends and patterns observed\n- `efficiency` - System efficiency assessment\n- `tomorrow_prediction` - Prediction for tomorrow\n- `confidence` - Prediction confidence level (high/medium/low)\n- `recommendation` - Actionable recommendation\n- `provider` - AI provider used (openai/gemini)\n- `model` - AI model used\n- `full_data` - Complete JSON response for advanced automation\n\n## Monitored Sensors\n\nThe integration monitors the following Growatt solar system sensors (customize these in `sensor.py` for your setup):\n\n- `sensor.growatt_solar_energy_today` - Daily solar energy production\n- `sensor.growatt_load_percentage` - Current load percentage\n- `sensor.growatt_battery_soc` - Battery state of charge\n\n## Data Update Frequency\n\nThe integration polls the AI service once per hour to analyze your energy data and provide updated predictions.\n\n## Requirements\n\n- Home Assistant 2023.1.0 or newer\n- An API key from OpenAI or Google Gemini\n- Solar energy sensors configured in Home Assistant\n\n## Privacy \u0026 Data\n\n- Your sensor data is sent to the selected AI provider for analysis\n- No data is stored by this integration beyond the latest prediction\n- Review the privacy policies of your chosen AI provider:\n  - [OpenAI Privacy Policy](https://openai.com/privacy)\n  - [Google Privacy Policy](https://policies.google.com/privacy)\n\n## Support\n\nFor issues, feature requests, or contributions, please visit the [GitHub repository](https://github.com/mujhtech/ai_energy_assistant).\n\n## License\n\nThis project is licensed under the MIT License.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## Disclaimer\n\nThis integration is not affiliated with OpenAI, Google, Growatt, or Home Assistant. Use at your own risk.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmujhtech%2Fai_energy_assistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmujhtech%2Fai_energy_assistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmujhtech%2Fai_energy_assistant/lists"}