https://github.com/korkuttum/tuya_heat_pump
This project allows you to control and monitor your Tuya cloud-based heat pump device through Home Assistant.
https://github.com/korkuttum/tuya_heat_pump
api arcelik axen beko cloud grundig heat heatpump home-assistant pump tuya
Last synced: 29 days ago
JSON representation
This project allows you to control and monitor your Tuya cloud-based heat pump device through Home Assistant.
- Host: GitHub
- URL: https://github.com/korkuttum/tuya_heat_pump
- Owner: Korkuttum
- License: mit
- Created: 2025-09-30T13:44:58.000Z (8 months ago)
- Default Branch: main-2.0.0
- Last Pushed: 2026-04-06T12:35:58.000Z (about 2 months ago)
- Last Synced: 2026-04-06T14:36:37.326Z (about 2 months ago)
- Topics: api, arcelik, axen, beko, cloud, grundig, heat, heatpump, home-assistant, pump, tuya
- Language: Python
- Homepage:
- Size: 635 KB
- Stars: 4
- Watchers: 3
- Forks: 5
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Support: supported_models.md
Awesome Lists containing this project
README
# Tuya Heat Pump - Home Assistant Integration
⚠️ **Note:**
> This integration has only been tested with the heat pump brands listed below.
> 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:
> [tuya_api_test.py](https://github.com/Korkuttum/tuya_heat_pump/blob/7d4303902f08a66663448902a00e3fc71efc0f4b/test/tuya_api_test.py)
### Supported Brands
- Arçelik (Beko, Grundig)
- Adlar Castra
- Aquark
- Aquatech X6
- Cordivari Vestalis
- Ecologic Ecopool
- EnviroSun HP+ _(Still not working yet.)_
- Evoheat 40T
- Heative Next
- Inventor Xforce
- Kushiro (Luqstoff)
- Mitte Aerotermia
- MyCond BeeThermic
- Poolsana
- Power World
- Pure Blue Onyx
- SolarEast
- Water TechniX
- W'eau
---
This project allows you to control and monitor your Tuya heat pump device through Home Assistant — supports both Cloud and Local (push) connection modes.
---
## Prerequisites
### Enabling Tuya IoT Cloud Service
To use this integration, you need to create a project in the Tuya IoT Platform, grant API access, and link your device to the project.
**Steps:**
1. Log in to [Tuya IoT Platform](https://iot.tuya.com/).
2. Go to “Cloud > Project Management” and create a new project or select an existing one.
3. In project details, go to the “API Group Authorization” tab.
4. Authorize essential API groups such as “Device Status” and “Device Control”.
5. In the “Link Device” section, add your heat pump device to the project.
6. Retrieve your Access ID and Access Secret from the project panel.
> ⚠️ **Important:** The integration will not work without API authorization and device linking.
---
## Installation
[](https://my.home-assistant.io/redirect/hacs_repository/?owner=Korkuttum&repository=tuya_heat_pump&category=integration)
### Method 1: Installation via HACS (Recommended)
1. Make sure you have HACS installed in your Home Assistant instance.
2. Click on HACS in the sidebar.
3. Click the three dots in the top right corner and select “Custom Repositories”.
4. Add the following repository URL and select “Integration” as the category:
```
https://github.com/Korkuttum/tuya_heat_pump
```
5. Click “ADD”.
6. Find "Tuya Heat Pump" in the integrations list and install it.
7. Restart Home Assistant.
Or, you can add it directly using the HACS badge above.
### Method 2: Manual Installation
- Upload all files to
`custom_components/tuya_heat_pump` folder inside your Home Assistant configuration directory.
- Restart Home Assistant.
---
## Configuration
After installation, restart Home Assistant and follow these steps:
1. Go to “Settings > Devices & Services”.
2. Click “Add Integration”.
3. Search for and select “Tuya Heat Pump”.
4. For Cloud mode: enter your Tuya IoT Platform credentials:
- Access ID
- Access Secret
- Device ID
5. For Local mode: switch the Connection Type to “Local” and enter:
- Device IP
- Local Key
- Protocol (e.g. 3.3 / 3.4)
- Device ID
---
## Notes
- You can monitor and control features like temperature, operation mode, and fan speed.
- Easily use in automations and dashboards.
---
## Support My Work
If you find this integration helpful, consider supporting the development:
[](https://www.patreon.com/korkuttum)
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Disclaimer
This 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.