Home Assistant integration for the Sourceful Zap - a local coordination gateway for distributed energy resources.

Status: In development. Targeting Home Assistant Core inclusion with Bronze tier quality scale.

The Zap is a ~$20 ESP32-based gateway enabling local energy coordination with <200ms response times - critical for grid services that cloud APIs (2-5s latency) cannot support.

Supported protocols: P1 · Modbus TCP/RTU · MQTT · OCPP · REST API

Learn more: sourceful.energy

Once published, install via HACS.

# Clone to custom_components
cd ~/.homeassistant/custom_components
git clone https://github.com/srcfl/zap-home-assistant.git sourceful_zap

For the working P1-only integration, use the legacy-v0.1 branch.

This integration follows Home Assistant development guidelines.

custom_components/sourceful_zap/
├── __init__.py          # Integration setup
├── manifest.json        # Integration metadata
├── config_flow.py       # UI configuration
├── coordinator.py       # Data fetching
├── sensor.py            # Sensor entities
├── const.py             # Constants
├── strings.json         # Translations
└── translations/        # Localized strings

See File Structure and Manifest docs.

# Set up dev environment
python -m venv venv
source venv/bin/activate
pip install homeassistant

# Run tests
pytest tests/

Join the discussion on Discord.

MIT - see LICENSE

Sourceful Labs AB · Kalmar, Sweden 🇸🇪