Home Assistant Integration Health Monitor

Check Home Assistant Core integrations and HACS/GitHub repositories for update risk, maintenance status, and breaking-change signals.

This Apify Actor is designed for Home Assistant power users, smart-home maintainers, and AI agents that need a structured signal before updating integrations.

What it checks

• GitHub repository activity: archived status, recent commits, recent releases, open issue count
• Open issue titles for failure keywords such as not working, crash, setup failed
• Breaking/deprecation keywords in issues and recent release titles
• Optional matching against a Home Assistant version string
• Home Assistant integration docs availability and selected docs keywords

What it does not do

• It does not connect to your private Home Assistant instance.
• It does not control devices or access secrets.
• It does not guarantee that an update is safe.
• It does not replace backups, staging tests, or reading release notes.

Example input

{
  "homeAssistantVersion": "2026.7.0",
  "integrations": ["reolink", "mqtt", "hue"],
  "hacsRepos": ["hacs/integration"],
  "includeCoreIntegrations": true,
  "includeHacsRepos": true,
  "lookbackDays": 90,
  "riskOnly": false,
  "maxItems": 10,
  "githubToken": "",
  "outputMode": "summary"
}

Example output

{
  "id": "github:hacs/integration",
  "name": "integration",
  "source_type": "hacs_repo",
  "repo": "hacs/integration",
  "health_score": 86,
  "risk_level": "low",
  "recommendation": "Low risk (86/100): recent commit activity. Review release notes before updating.",
  "open_issues": 42,
  "critical_issue_count": 0,
  "breaking_change_count": 0,
  "sources": ["https://github.com/hacs/integration"]
}

Risk scoring

• low: score >= 80 and no hard red flags
• medium: score 55-79 or update-related warnings
• high: score < 55, archived repos, or strong abandonment/deprecation signals

Scoring uses a transparent heuristic, not a hidden LLM. It is intended to prioritize review work, not to make final update decisions.

Pricing recommendation

Recommended pay-per-event setup:

• Keep Apify's synthetic apify-actor-start event at its default price.
• Add one custom event: integration-check.
• Suggested initial price for integration-check: $0.01.

The code pushes each dataset item with the integration-check event name and stops when the user's configured charge limit is reached.

Local development

python -m venv .venv
. .venv/bin/activate
pip install -r requirements-dev.txt
pytest
python scripts/run_local.py examples/input.json

Apify deployment

apify login
apify push

Then configure monetization in Apify Console under the Actor's Publication tab.