Aquarium AI for Home Assistant
This is a custom integration I made to have AI analyse and evaluate your sensors based on common aquarium parameters.
Features
- AI-Powered Analysis: Leverages the built-in
ai_taskservice to generate natural language analyses of your aquarium’s conditions. - Dynamic Entity Creation: Automatically creates text sensors for each AI analysis point (e.g., temperature, pH, overall health) based on the sensors you provide.
- Water Change Recommendations: AI evaluates when water changes are needed based on parameters, bioload, filtration, and maintenance schedule.
- Context-Aware Analysis: Optionally provide tank volume, filtration details, inhabitants, and maintenance history for more accurate recommendations.
- Camera Visual Analysis: Optional camera integration for AI-powered visual monitoring of water clarity, fish health, plant condition, and maintenance needs.
- Binary Sensors: Simple on/off indicators for water change needs and other critical conditions.
- UI Configuration: Simple setup process through the Home Assistant UI. No YAML configuration is required.
- Customizable Polling: Choose how often the AI analysis should run, from every hour to once a day.
- On-Demand Updates: Trigger an analysis at any time using a service call, perfect for automations and custom schedules.
- Multiple Notification Formats: Choose between detailed, condensed, or minimal notification styles.
AquaPi for ESPHome
It pairs great with my custom hardware:
The Aquarium meets the Smart Home! Add more sensors to Home Assistant!
Setup Guide
Build It Yourself
Wiki
Join the conversation on Reef2Reef!
Buy Now!
Aquarium AI App
Your Intelligent Aquatic Assistant
Take the guesswork out of aquarium keeping with Aquarium AI! Our powerful, AI-driven tools help both new and seasoned aquarists create a thriving underwater ecosystem.
Unlock the Power of AI with Your Own API Key!
Aquarium AI is different from other AI-enabled aquarium apps. We empower you by allowing you to use your own AI API keys from Gemini, OpenAI, and Groq. This unique “Bring Your Own Key” model gives you:
Higher AI API Call Limits: Enjoy significantly more interactions with our AI, including the powerful Gemini 2.5 flash.
Unlimited Features: Get unrestricted access to all our features, including the ability to add and manage an unlimited number of tanks.
Key Features:
Intelligent AI Chatbot: Have a question about your tank? Get expert advice on water parameters, fish health, tank maintenance, and more, 24/7.
AI Fish Compatibility Tool: Instantly analyze the compatibility of different fish species with in-depth reports and personalized care guides.
AI Stocking Assistant: Plan your dream aquarium with confidence. Get custom stocking recommendations based on your tank size, experience level, and desired fish type.
My Tanks: Create and manage your custom tanks with inhabitants. Get personalized stocking recommendations for your tanks.
Photo Analysis: Analyze photos of your fish and tank. Our AI can help identify species, detect potential health issues, and provide recommendations.
Aquarium Calculators: Access essential tools for managing your aquarium’s technical details, including a handy Tank Volume Calculator.

