AI-Powered Electricity Bill Error Detection and Savings Agent
Features • Tech Stack • Project Structure • Installation • Usage • Screenshots
BillGuard AI is a comprehensive full-stack solution designed to empower consumers against electricity bill overcharging and inefficiencies. By leveraging state-of-the-art Computer Vision, Optical Character Recognition (OCR), and advanced AI/ML algorithms, BillGuard analyzes user-uploaded electricity bills to verify accurate meter readings and calculated charges.
It crosses the extracted data with official state-specific tariffs, detects discrepancies, intelligently generates targeted complaints, and provides concrete savings recommendations. Say goodbye to confusing electric charges and welcome automated savings.
- 📄 AI Bill Extraction & Parsing: Easily upload your electricity bills in PDF or Image formats. Our AI accurately extracts consumer details, billed units, and itemized charges with 98%+ accuracy.
- 🔍 Smart Error Detection: The engine cross-checks mathematically computed charges against complex, official statutory state tariffs to pinpoint overcharges instantly.
- 📸 Meter Photo Verification: Upload a photo of your physical electricity meter to objectively validate mathematically billed units.
- 📝 Auto Complaint Generator: If an overcharge or discrepancy is detected, BillGuard generates automated, professionally articulated complaint drafts along with evidence to file disputes seamlessly.
- 💰 Personalized Savings Recommendations: Get custom-tailored, actionable insights and tips to optimize energy consumption and lower future bills.
- 🤖 Integrated AI Assistant: Resolve tariff-related questions instantly and get your bill explained plainly by our integrated chatbot.
The interface is designed with a premium, responsive modern aesthetic focusing on user experience.
- React 18 & TypeScript for robust, type-safe components.
- Vite for lightning-fast module bundling and HMR.
- TailwindCSS for utility-first, custom styling.
- Framer Motion for highly dynamic scroll & transition animations.
- Lucide React for scalable vector icons.
The backend is highly optimized for complex AI computations and data management.
- Python 3.11+ native environment.
- FastAPI for reliable, high-performance async RESTful APIs.
- OCR & Computer Vision routines for robust document parsing.
- AI/ML Agents to calculate tariff logic and perform contextual explanations.
billguard/
├── frontend-vite/ # React frontend environment
│ ├── src/
│ │ ├── components/ # Reusable UI components (buttons, cards, forms)
│ │ ├── pages/ # Full page views (Landing, Dashboard, Auth)
│ │ ├── lib/ # Utilities and helper functions
│ │ └── ...
│ └── package.json # Frontend dependencies
│
└── backend/ # Python FastAPI backend environment
├── app/ # Main application logic
│ ├── api/ # API routing handlers
│ ├── agents/ # AI models and analysis logic
│ └── services/ # Core business logic methods
├── main.py # FastAPI entry point
└── requirements.txt # Python dependencies
Before you begin, ensure you have the following installed on your machine:
- Node.js (v18 or higher)
- Python (v3.11 or higher)
- npm or yarn
Navigate to the frontend directory, install dependencies, and run the development server.
cd frontend-vite
npm install
npm run devThe site will be available locally (usually at http://localhost:5173).
Navigate to the Python backend directory, install required packages, and launch FastAPI.
cd backend
pip install -r requirements.txt
uvicorn main:app --reload
# Or alternately run python main.pyThe REST API will be available locally (usually at http://localhost:8000).
- Sign Up/Log In: Register an account securely via the portal interface.
- Upload Bill: Upload your recent electricity bill documentation natively as a PDF or image file.
- Upload Meter (Optional): Upload an image of your meter to double-check unit reads visually.
- View Analysis: Wait momentarily as the system processes the OCR extraction and tariff verification to reveal overcharges, warnings, or confirmations of accuracy.
- Take Action: Review personalized savings recommendations. If inconsistencies arise, generate dispute drafts directly from the dashboard.
Contributions, issues, and feature requests are welcome! Feel free to check the issues page.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request.
This project is licensed under the MIT License. See the LICENSE file for details.