AIgua is an AI-powered assistant designed to help people easily understand water quality test results. Whether the water is for drinking, cleaning, or irrigation, AIgua provides clear explanations, risk assessments, and treatment suggestions — all with a human tone.
Built as part of the AI Agent Hackathon with IBM watsonx.ai, this project supports the UN’s Sustainable Development Goal #6: Clean Water and Sanitation.
Main interface showing test result input and AI diagnosis.
Community map showing shared water analyses across regions.
- ✅ Friendly, AI-generated analysis of water test results
- 💡 Personalized diagnosis based on pH, TDS, turbidity, and free chlorine
⚠️ Risk explanations and treatment suggestions using internal rules + RAG (retrieve-augmented generation)- 🌍 Optional map where users can anonymously share their test data
- 🔐 Safe-by-design — no personal data required
- 📱 Built with React (frontend) + Python backend + IBM watsonx.ai
AIgua combines:
- Internal rules for quick evaluation of common parameters
- Watsonx.ai + LangChain to generate friendly, accessible analysis
- RAG (Retrieve-Augmented Generation) for deeper insight using trusted sources (e.g., WHO, EPA)
- Firestore for storing shared anonymous results
- React Leaflet for map visualization
| Layer | Tech |
|---|---|
| Frontend | React + TypeScript + Vite |
| Backend | Python + LangChain + FastAPI |
| AI Model | IBM watsonx.ai (Granite model) |
| Retrieval | Custom RAG pipeline with LangChain |
| Map & DB | React Leaflet + Firebase Firestore |
| Styling | Tailwind CSS |
- Node.js + npm
- Python 3.10+
- Firebase account (for map and shared data)
- IBM Cloud + watsonx.ai access
cd waterbuddy-frontend
npm install
npm run devThe frontend will run at
http://localhost:5173
cd waterbuddy-backend
python -m venv venv
source venv/bin/activate # or venv\Scripts\activate on Windows
pip install -r requirements.txt
python main.pyMake sure to configure your
credentials.pywith IBM and Firebase settings.
{
"pH": 7.2,
"TDS": 650,
"turbidity": 3.0,
"free_chlorine": 0.15,
"usage": "watering vegetables"
}
We welcome contributions! To get started:
- Fork the repo
- Create a new branch (
git checkout -b feature-name) - Commit your changes (
git commit -m 'Add feature') - Push to the branch (
git push origin feature-name) - Create a Pull Request
This project was developed as part of the AI Agent Hackathon with IBM watsonx.ai, focusing on SDG 6: Clean Water and Sanitation.
This project is licensed under the Apache License 2.0.
It allows for commercial use, modification, distribution, and private use, provided that proper attribution and license notice are maintained.
- Use the code for personal, educational, or commercial purposes
- Modify and distribute it under the same license
- Use any trademarks, service marks, or logos of the project without permission
- Use the project in ways that violate the license terms
For full license details, see the LICENSE file in this repository.
- IBM & Call for Code team
- LangChain & open-source agentic frameworks
- World Health Organization (WHO) & EPA for open guidelines
“Water is life. Let’s make sure it’s safe for everyone.”