{"id":42168372,"url":"https://github.com/korkuttum/tuya_heat_pump","last_synced_at":"2026-07-17T22:01:01.892Z","repository":{"id":317382749,"uuid":"1067181672","full_name":"Korkuttum/tuya_heat_pump","owner":"Korkuttum","description":"This project allows you to control and monitor your Tuya cloud-based heat pump device through Home Assistant.","archived":false,"fork":false,"pushed_at":"2026-07-13T09:09:40.000Z","size":1082,"stargazers_count":11,"open_issues_count":11,"forks_count":10,"subscribers_count":4,"default_branch":"main-2.4.0","last_synced_at":"2026-07-13T10:21:50.403Z","etag":null,"topics":["api","arcelik","axen","beko","cloud","grundig","heat","heat-pump","heater","heatpump","home-assistant","homeassistant","pool","pump","tuya"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Korkuttum.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"supported_models.md","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-09-30T13:44:58.000Z","updated_at":"2026-07-13T09:10:01.000Z","dependencies_parsed_at":"2025-10-16T10:55:46.774Z","dependency_job_id":"985a15d8-7267-4f02-b33d-713e78006ae5","html_url":"https://github.com/Korkuttum/tuya_heat_pump","commit_stats":null,"previous_names":["korkuttum/tuya_heatpump","korkuttum/tuya_heat_pump"],"tags_count":74,"template":false,"template_full_name":null,"purl":"pkg:github/Korkuttum/tuya_heat_pump","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Korkuttum%2Ftuya_heat_pump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Korkuttum%2Ftuya_heat_pump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Korkuttum%2Ftuya_heat_pump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Korkuttum%2Ftuya_heat_pump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Korkuttum","download_url":"https://codeload.github.com/Korkuttum/tuya_heat_pump/tar.gz/refs/heads/main-2.4.0","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Korkuttum%2Ftuya_heat_pump/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35597010,"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-07-17T02:00:06.162Z","response_time":116,"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":["api","arcelik","axen","beko","cloud","grundig","heat","heat-pump","heater","heatpump","home-assistant","homeassistant","pool","pump","tuya"],"created_at":"2026-01-26T21:20:09.348Z","updated_at":"2026-07-17T22:01:01.876Z","avatar_url":"https://github.com/Korkuttum.png","language":"Python","funding_links":["https://www.patreon.com/korkuttum"],"categories":[],"sub_categories":[],"readme":"# Tuya Heat Pump - Home Assistant Integration\n\n\u003cimg src=\"https://raw.githubusercontent.com/Korkuttum/tuya_heat_pump/main-2.4.0/images/heatpump.webp\" width=\"200\"\u003e\n\n ⚠️ **Note:**  \n\u003e This integration has only been tested with the heat pump brands listed below.  \n\u003e If your heat pump is a different brand and the integration does not work, please run the script at the following link and share the generated file with me:  \n\u003e [tuya_api_test.py](https://github.com/Korkuttum/tuya_heat_pump/blob/main-2.4.0/test/tuya_api_test.py)\n### Supported Brands\n📋 **[Detailed list](https://github.com/Korkuttum/tuya_heat_pump/blob/main-2.4.0/supported_models.md)**\n- Arçelik (Beko, Grundig)\n- ACIQ\n- Adlar Castra\n- Aquark\n- Aquastrong \n- Aquatech X6\n- Cordivari Vestalis\n- Della\n- Ecologic Ecopool\n- EnviroSun HP+\n- Evoheat 40T\n- Fairland\n- Fairland Inverter Plus\n- Heative Next\n- Inventor Xforce\n- IPS Pool Systems\n- ITS\n- Ivapool\n- Kensol\n- Kushiro (Luqstoff)\n- Mango\n- Mitte Aerotermia\n- MyCond BeeThermic\n- Poolsana\n- Power World\n- Power World PW030\n- Power World R290 Full DC\n- Pure Blue Onyx\n- Reclaim Eco R290\n- Rotenso\n- SolarEast\n- SolarEast BLN\n- Swim\u0026Fun Fjord\n- Water TechniX\n- W'eau\n- W'eau WFI-007\n- Wopoltop\n---\n\nThis project allows you to control and monitor your Tuya heat pump device through Home Assistant — supports both Cloud and Local (push) connection modes.\n\n---\n\n## Prerequisites\n\n### Enabling Tuya IoT Cloud Service\n\nTo use this integration, you need to create a project in the Tuya IoT Platform, grant API access, and link your device to the project.\n\n**Steps:**\n\n1. Log in to ***[Tuya IoT Platform](https://iot.tuya.com/)***.\n2. Go to ***Cloud \u003e Project Management*** and create a new project or select an existing one.\n3. Select the ***Devices*** tab:\n   - If your devices are already listed, proceed to the next step.\n   - If you have no devices yet, open the ***Link App Account*** tab below. Click the ***Add App Account*** button on the right, then select ***Tuya App Account Authorization***. Scan the QR code using your Tuya mobile app and grant permission. Your devices will then appear.\n4. Click on the ***Service API*** tab above, then click the ***Go to Authorize*** button and add the following APIs to your project:\n   - ***IoT Core***\n   - ***Smart Home Basic Service***\n   - ***Device Status Notification***\n   - ***Authorization Token Management***\n5. Retrieve your ***Access ID*** and ***Access Secret*** from the project panel.\n\n\u003e ⚠️ **Important:** The integration will not work without API authorization and device linking.\n\n---\n\n## Installation\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=Korkuttum\u0026repository=tuya_heat_pump\u0026category=integration)\n\n### Method 1: Installation via HACS (Recommended)\n\n1. Make sure you have **HACS** installed in your Home Assistant instance.\n2. Go to **HACS** → **Integrations**.\n3. Click the search icon in the top right and search for **\"Tuya Heat Pump\"**.\n4. Click **Download** on the integration.\n5. Restart Home Assistant.\n\n### Method 2: Manual Installation\n\n1. Download the latest release from the [GitHub repository](https://github.com/Korkuttum/tuya_heat_pump).\n2. Extract the files and copy the `tuya_heat_pump` folder into your Home Assistant `custom_components` directory.\n3. Restart Home Assistant.\n---\n\n## Configuration\n\nAfter installation, restart Home Assistant and follow these steps:\n\n1. Go to “Settings \u003e Devices \u0026 Services”.\n2. Click “Add Integration”.\n3. Search for and select “Tuya Heat Pump”.\n4. For Cloud mode: enter your Tuya IoT Platform credentials:\n    - Access ID\n    - Access Secret\n    - Device ID\n5. For Local mode: switch the Connection Type to “Local” and enter:\n    - Device IP\n    - Local Key\n    - Protocol (e.g. 3.3 / 3.4)\n    - Device ID\n\n---\n\n## Notes\n\n- You can monitor and control features like temperature, operation mode, and fan speed.\n- Easily use in automations and dashboards.\n\n---\n\n## Support My Work\n\nIf you find this integration helpful, consider supporting the development:\n\n[![Become a Patreon](https://img.shields.io/badge/Become_a-Patron-red.svg?style=for-the-badge\u0026logo=patreon)](https://www.patreon.com/korkuttum)\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Disclaimer\n\nThis integration is an independent project and is not affiliated with, endorsed by, or connected to Tuya Inc. in any way. This is a community project provided \"as is\" without warranty of any kind. Use at your own risk.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkorkuttum%2Ftuya_heat_pump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkorkuttum%2Ftuya_heat_pump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkorkuttum%2Ftuya_heat_pump/lists"}