{"id":49246438,"url":"https://github.com/pvyleta/xcc-integration","last_synced_at":"2026-04-24T22:02:36.396Z","repository":{"id":301795912,"uuid":"1010272157","full_name":"pvyleta/xcc-integration","owner":"pvyleta","description":"Home Assistant Integration for XCC2 regulation for 'AC Heating' heat pumps","archived":false,"fork":false,"pushed_at":"2026-04-22T21:21:26.000Z","size":8020,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-22T22:29:55.976Z","etag":null,"topics":["custom-component","hacs","heat-pump","home-assistant","integration","xcc"],"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/pvyleta.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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-06-28T18:04:09.000Z","updated_at":"2026-04-22T21:21:30.000Z","dependencies_parsed_at":"2025-06-28T22:23:32.076Z","dependency_job_id":"cd1bf397-93fe-48b4-b7d3-d92bf7535e9f","html_url":"https://github.com/pvyleta/xcc-integration","commit_stats":null,"previous_names":["pvyleta/xcc-integration"],"tags_count":156,"template":false,"template_full_name":null,"purl":"pkg:github/pvyleta/xcc-integration","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pvyleta%2Fxcc-integration","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pvyleta%2Fxcc-integration/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pvyleta%2Fxcc-integration/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pvyleta%2Fxcc-integration/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pvyleta","download_url":"https://codeload.github.com/pvyleta/xcc-integration/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pvyleta%2Fxcc-integration/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32242315,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T13:21:15.438Z","status":"ssl_error","status_checked_at":"2026-04-24T13:21:15.005Z","response_time":64,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["custom-component","hacs","heat-pump","home-assistant","integration","xcc"],"created_at":"2026-04-24T22:02:33.871Z","updated_at":"2026-04-24T22:02:36.388Z","avatar_url":"https://github.com/pvyleta.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AC Heating XCC Heat Pump Controller Integration\n\nHome Assistant integration for AC Heating XCC heat pump controllers with photovoltaic integration. Monitor and control your heat pump system directly from Home Assistant with automatic entity discovery and bilingual support.\n\nInspired by work in https://github.com/Pdobry/xcc-graph.\n\n## 🏠 Home Assistant Integration Features\n\n- 🔧 **470+ settable fields** automatically discovered across 8 configuration pages\n- 📊 **Live data monitoring** with real-time sensor values\n- 🌐 **Bilingual support** (English/Czech with auto-detection)\n- 📋 **Organized by device** (heating, PV, hot water, auxiliary source, etc.)\n\n## 📦 HACS Installation\n\n1. **Add Custom Repository**:\n   - Open HACS in Home Assistant\n   - Click the 3 dots (⋮) → \"Custom repositories\"\n   - Add repository: `https://github.com/pvyleta/xcc-integration`\n   - Category: `Integration`\n\n2. **Install Integration**:\n   - Go to HACS \u003e Integrations\n   - Search for \"XCC Heat Pump Controller\"\n   - Click \"Download\" and restart Home Assistant\n\n3. **Configure Integration**:\n   - Settings \u003e Devices \u0026 Services \u003e \"Add Integration\"\n   - Search for \"XCC Heat Pump Controller\"\n   - Enter your XCC controller details\n\n## 🔧 Development \u0026 Testing\n\n### Development Setup\n\n1. **Clone the repository:**\n   ```bash\n   git clone https://github.com/pvyleta/xcc-integration\n   cd xcc-integration\n   ```\n\n2. **Create virtual environment:**\n   ```bash\n   python -m venv venv\n   source venv/bin/activate  # On Windows: venv\\Scripts\\activate\n   ```\n\n3. **Install dependencies:**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n### Running Tests\n\nThe integration includes comprehensive tests to ensure reliability:\n\n```bash\n# Run all tests\npython -m pytest tests/ -v\n```\n\n## 📚 Configuration Pages\n\nThe integration automatically discovers entities from these XCC pages:\n\n| Page | Description | Typical Entities |\n|------|-------------|------------------|\n| **Heating Circuits** | Temperature control, schedules | Temperature sensors, setpoint controls |\n| **Photovoltaics** | Battery management, export limits | Power sensors, battery controls |\n| **PV Inverter** | Inverter configuration and telemetry | String/phase sensors, inverter settings |\n| **Hot Water** | Sanitization, circulation | Water temperature, heating controls |\n| **Auxiliary Source** | Backup heating system | Status sensors, operation controls |\n| **Spot Pricing** | Dynamic pricing optimization | Price sensors, optimization switches |\n| **System Status** | Overall system information | Status sensors, diagnostic data |\n| **Heat Pump Settings** | Advanced configuration (discovered dynamically) | Configuration switches, numbers |\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpvyleta%2Fxcc-integration","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpvyleta%2Fxcc-integration","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpvyleta%2Fxcc-integration/lists"}