KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #codex #typescript #developer-tools #ai-agents #deepseek-harness #claude-code #ai-agent #cli #react #mcp

esphome-deye-inverter

★ 89 Open GitHub ↗

An easy way to integrate Deye 3P & 1P PV inverters with Home Assistant using the ESPHome platform.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ESPHome Deye Inverter

<!--
Copyright 2025 Lewa-Reka <lewareka.yt@gmail.com>

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->

![Maintenance](https://img.shields.io/maintenance/yes/2026?style=for-the-badge)
![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/lewa-reka/esphome-deye-inverter/build-ci.yaml?style=for-the-badge)
![GitHub License](https://img.shields.io/github/license/lewa-reka/esphome-deye-inverter?style=for-the-badge)
![GitHub commit activity](https://img.shields.io/github/commit-activity/y/lewa-reka/esphome-deye-inverter?style=for-the-badge)

An ESPHome-based solution for monitoring and controlling Deye photovoltaic inverters via Modbus RTU communication. This project provides comprehensive integration with Home Assistant, enabling real-time monitoring and control of solar power systems.

Installation & Presentation: https://youtu.be/iJjsA_MzmnE [PL]

## 📚 Documentation

- **[Supported Devices](docs/SUPPORTED_DEVICES.md)**: List of supported inverters and specific configurations.
- **[Features & Capabilities](docs/FEATURES.md)**: Detailed overview of features, safety mechanisms, and monitoring capabilities.
- **[Installation Guide](docs/INSTALLATION.md)**: Hardware requirements, wiring diagrams, and step-by-step installation instructions.
- **[Configuration](docs/CONFIGURATION.md)**: Configuration options, parameters, and update instructions.
- **[Troubleshooting](docs/TROUBLESHOOTING.md)**: Common issues and solutions.
- **[Contributing](docs/CONTRIBUTING.md)**: Guidelines for contributing to the project.

## 🎨 Home Assistant Visualization Examples

The integration works seamlessly with the **[Sunsynk Power Flow Card](https://github.com/slipx06/sunsynk-power-flow-card)** by [slipx06](https://github.com/slipx06), providing an elegant visualization of energy flow in your photovoltaic system. Below are example card configurations available for 3-phase inverters:

![Sunsynk Power Flow Card Examples](https://raw.githubusercontent.com/Lewa-Reka/esphome-deye-inverter/main/docs/examples/img/card_3p_all.png)

### Card Styles:

- **[Example 1: Full Style (Modern)](docs/examples/SUNSYNK_POWER_FLOW_CARD.md#example-1-full-style-modern---3-phase)** - Modern style with large fonts, ideal for standard dashboard views
- **[Example 2: Compact Style](docs/examples/SUNSYNK_POWER_FLOW_CARD.md#example-2-compact-style---3-phase)** - Compact style that saves space, featuring a Deye-style inverter icon
- **[Example 3: Wide Style with Dual Battery](docs/examples/SUNSYNK_POWER_FLOW_CARD.md#example-3-wide-style-with-dual-battery---3-phase)** - Wide style with dual battery support, perfect for wider dashboard layouts (tablets, desktops)

Detailed installation instructions and full configurations can be found in the [examples documentation](docs/examples/SUNSYNK_POWER_FLOW_CARD.md)

## 📄 License

This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.

### Copyright Notice

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

### Third-Party Components

This project uses ESPHome and related components. Please refer to the [NOTICE](NOTICE) file for additional license information.

## 🙏 Acknowledgments

- [Solarman Stick Logger by David Rapan](https://github.com/davidrapan/ha-solarman) and [pilipphenkel](https://github.com/philipphenkel/esphome-config) for inspirations
- [Sunsynk Power Flow Card by slipx06](https://github.com/slipx06/sunsynk-power-flow-card) for the excellent visualization card
- [ESPHome Team](https://esphome.io/) for the excellent home automation platform
- [Home Assistant Community](https://community.home-assistant.io/) for continuous support and inspiration
- All contributors and testers who helped improve this integration

## 📞 Support

- **GitHub Issues**: [Report bugs or request features](https://github.com/Lewa-Reka/esphome-deye-inverter/issues)
- **Discussions**: [GitHub Discussions](https://github.com/Lewa-Reka/esphome-deye-inverter/discussions) for questions and community support
- **Home Assistant Community**: [ESPHome section](https://community.home-assistant.io/c/esphome/) for general ESPHome help

## 🔗 Related Projects

- [HA-Solarman](https://github.com/davidrapan/ha-solarman) - Alternative WiFi stick integration
- [Sunsynk Power Flow Card](https://github.com/slipx06/sunsynk-power-flow-card) - Home Assistant card for visualizing solar power flow
- [ESPHome Official Docs](https://esphome.io/) - ESPHome documentation

---

**⚠️ Disclaimer**: This project is not officially affiliated with Deye. Use at your own risk and ensure compliance with local electrical codes and regulations. Always consult with a qualified electrician for installation and safety verification. The authors are not responsible for any damage to equipment or injury resulting from the use of this software.

esphome-deye-inverter

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README