<img ="left" src="https://github.com/TheRealFalseReality/aquapi/blob/5e4a82a5755e06d9029109c4bd55601596198b7c/assests/image/AquaPi%20Logo.png" alt="drawing" style="width:120px;"/>
The Aquarium meets the Smart Home!
Setup Guide
Build It Yourself
Join the conversation on Reef2Reef!
AquaPi for ESPHome is a project that helps you build a powerful aquarium monitoring and automation system using affordable ESPHome devices and Home Assistant. Make endless automations and monitor temperature, water level, and upgrade for advanced aquarium monitoring: pH, salinity, dissolved oxygen, and more (using EZO circuits and probes).
Why use AquaPi?
- Open-source: Freely available for anyone to access, modify, and contribute to.
- Modular: Designed to be easily expanded and customized based on your specific needs.
- Modernized: Utilizes the latest technologies and tools for a seamless user experience.
- Customizable: Adapt the system to fit your unique aquarium setup and monitoring preferences.
- Versatile: Expand the system's capabilities with your own compatible sensors and equipment.
- Affordable: Offers a cost-effective alternative to many high-end monitoring solutions.
- Powerful: Provides comprehensive monitoring capabilities for various water parameters.
 |
 |
|---|
UI
 |
 |
|---|
If you want to try some of the Dashboard or Cards I use, follow the link below. You may need additional integrations or custom cards for some of them!
Example HomeAssistant Cards & Templates
ESP32 devkit
HomeAssistant using a Raspberry Pi 3 or above. The more RAM, the better.
Prerequisite!! A Raspberry Pi (or something similar) running HomeAssistant to communicate and interact with the ESP32 via homeassistant.local:8123.
Get Raspberry Pi Imager
Temperature
- DS18B20 Waterproof Thermistor
Water Level
- Food Grade Optical Infrared Water Liquid Level Sensor
Water Leak Sensor
- Liquid Detection Sensor, 6ft Cable, 2 Mounting Screws w/Magnetic Mount
pH: Atlas Scientific pH: EZO-pH & Lab Grade pH Probe
- EZO™ pH Circuit, ISO 10523 Compliant
- Double junction silver / silver chloride Lab Grade pH Probe with Vanadium III, Gen 3
- Electrically Isolated EZO™ Carrier Board
- Range: 0 - 14
- Time Before Recalibration: 1 Year
- Life Expectancy: ~2.5+ Years
Salinity: Atlas Scientific Conductivity: EZO-EC & Conductivity Probe K 1.0
- EZO™ EC Circuit, ISO 7888 Compliant
- Conductivity Probe K 1.0, Graphite, Gen 3
- Electrically Isolated EZO™ Carrier Board
- Range: 0.07 − 500,000+ μS/cm
- Time Before Recalibration: ~10 Years
- Life Expectancy: ~10 Years
Dissolved Oxygen: Atlas Scientific DO: EZO-DO & Dissolved Oxygen Probe
- EZO™ DO Embedded Circuit
- Range: 0.00 - 100 mg/L (0 - 350% saturation)
- Life Expectancy: ~4 Years
ORP: Atlas Scientific ORP: EZO-ORP & ORP Probe
- EZO™ ORP Embedded Circuit
- Range: -2000mV - 2000 mV
- Life Expectancy: ~2 Years
Peristaltic Dosing Pump: Atlas Scientific Pump: EZO-PMP
- EZO™ Pump Embedded Circuit
- Flow Rate: 0.5ml to 105ml/min
- Tube Size: 5mm
- Head Height: 8.1m(26.5')
Carbon Dioxide Air: Atlas Scientific CO2: EZO-CO2
- EZO™ CO2 Embedded Circuit, Gaseous
- Range: 0 − 10,000 ppm
- Life Expectancy: ~5.5 Years
Other EZO probes that should work but not yet tested:
Humidity,
Temperature
See Wiki for more details on the circuit.
Home Assistant: Open source home automation that puts local control and privacy first.
ESPHome: A system to control your ESP8266/ESP32 and RP2040 by simple yet powerful configuration files and control them remotely through Home Automation systems.
See Wiki for Setup Guides that Include:
Setting up Home Assistant and Connecting AquaPi to your Wifi.
Updating the AquaPi.
Connecting to the AquaPi without Home Assistant.
See Wiki
These are scripts and automations I created to control other devices within Home Assistant.
See Wiki for guides when installing on a non-configured ESP32 device.
See Wiki for more information on customizing your device.