Skip to content

Latest commit

ย 

History

18 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

โšก AI Building Energy Decision Agent

An Agentic AI-powered platform for intelligent building energy monitoring, optimization, and decision support.

Status Python Frontend License


๐Ÿ“– Overview

The AI Building Energy Decision Agent is an intelligent energy optimization platform developed as part of the LTTS Hackathon.

The application continuously monitors building energy usage, identifies inefficiencies, analyzes the causes using AI, estimates savings, and recommends optimization strategies to improve operational efficiency while reducing energy consumption.

The platform combines real-time monitoring, Agentic AI reasoning, interactive AI consultation, and intelligent recommendations into a single dashboard.


โœจ Features

๐Ÿ“Š Live Energy Dashboard

  • Real-time energy monitoring
  • Live meter simulation
  • Building energy KPIs
  • Dynamic charts and visualizations
  • Historical energy trends

๐Ÿ‘€ Observation Engine

Automatically detects:

  • High energy consumption
  • Sudden power spikes
  • Energy wastage
  • Idle equipment
  • Abnormal consumption patterns
  • Unusual operating conditions

๐Ÿง  Reasoning Engine

Analyzes detected observations and identifies:

  • Root causes
  • Severity level
  • Confidence score
  • Business impact
  • Priority of issues

๐Ÿ’ก Recommendation Engine

Provides AI-generated recommendations such as:

  • HVAC optimization
  • Lighting optimization
  • Peak demand reduction
  • Equipment scheduling
  • Idle device shutdown
  • Load balancing
  • Operational improvements

๐Ÿ’ฐ Savings & ROI Engine

Estimates:

  • Energy Savings
  • Monthly Savings
  • Annual Savings
  • Carbon Emission Reduction
  • Return on Investment (ROI)

๐Ÿค– AI Building Energy Consultant

Interactive AI assistant capable of:

  • Answering energy-related questions
  • Explaining recommendations
  • Explaining observations
  • Suggesting optimization strategies
  • Helping building managers make better decisions

๐Ÿ”ฎ What-if Simulation

Allows users to simulate different optimization scenarios before implementation.

Example simulations:

  • Reduce HVAC runtime
  • Shift energy loads
  • Turn off idle equipment
  • Change operating schedules

The AI predicts:

  • Expected energy savings
  • Cost reduction
  • Carbon reduction
  • ROI impact

๐Ÿ—๏ธ System Architecture

                    React Frontend
                           โ”‚
                           โ”‚ REST APIs
                           โ–ผ
                    FastAPI Backend
                           โ”‚
      โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
      โ”‚            โ”‚            โ”‚             โ”‚
 Observation   Reasoning   Recommendation   AI Consultant
   Engine        Engine        Engine       (LLM)
      โ”‚            โ”‚            โ”‚
      โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                  โ”‚
          Savings & ROI Engine
                  โ”‚
        Live Dashboard Updates

๐Ÿ› ๏ธ Technology Stack

Frontend

  • React
  • TypeScript
  • Vite
  • Tailwind CSS

Backend

  • FastAPI
  • Python
  • Pydantic

Artificial Intelligence

  • Agentic AI
  • GPT Models
  • Prompt Engineering

APIs

  • REST APIs
  • Live Energy Simulation

๐Ÿ“‚ Project Structure

EnergyDecisionAgent/

โ”œโ”€โ”€ backend/
โ”‚   โ”œโ”€โ”€ app/
โ”‚   โ”‚   โ”œโ”€โ”€ api/
โ”‚   โ”‚   โ”œโ”€โ”€ services/
โ”‚   โ”‚   โ”œโ”€โ”€ models/
โ”‚   โ”‚   โ”œโ”€โ”€ schemas/
โ”‚   โ”‚   โ”œโ”€โ”€ utils/
โ”‚   โ”‚   โ””โ”€โ”€ main.py
โ”‚   โ”œโ”€โ”€ requirements.txt
โ”‚   โ””โ”€โ”€ .env
โ”‚
โ”œโ”€โ”€ frontend/
โ”‚   โ”œโ”€โ”€ src/
โ”‚   โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”‚   โ”œโ”€โ”€ hooks/
โ”‚   โ”‚   โ”œโ”€โ”€ pages/
โ”‚   โ”‚   โ”œโ”€โ”€ services/
โ”‚   โ”‚   โ”œโ”€โ”€ context/
โ”‚   โ”‚   โ””โ”€โ”€ App.tsx
โ”‚   โ”œโ”€โ”€ package.json
โ”‚   โ””โ”€โ”€ vite.config.ts
โ”‚
โ”œโ”€โ”€ README.md
โ””โ”€โ”€ .gitignore

๐Ÿš€ Installation

Clone the Repository

git clone https://github.com/MalviyaSir/EnergyDecisionAgent.git

Move into the project folder:

cd EnergyDecisionAgent

โš™๏ธ Backend Setup

Open a terminal.

Navigate to the backend folder:

cd backend

Install dependencies:

pip install -r requirements.txt

If your project uses environment variables, create a .env file and add the required values.

Start the backend server:

uvicorn app.main:app --reload

The FastAPI backend will start successfully.


๐Ÿ’ป Frontend Setup

Open another terminal.

Navigate to the frontend folder:

cd frontend

Install frontend dependencies:

npm install

Start the frontend:

npm run dev

Vite will display the local development URL, typically:

http://localhost:5173

Open it in your browser.


โ–ถ๏ธ Running the Project

Terminal 1

cd backend

uvicorn app.main:app --reload

Terminal 2

cd frontend

npm run dev

The application will be available in your browser after both backend and frontend are running.


๐Ÿ”„ Application Workflow

  1. Live energy data is generated through the simulator.
  2. The Observation Engine continuously monitors the readings.
  3. The Reasoning Engine identifies the root causes of inefficiencies.
  4. The Recommendation Engine generates intelligent optimization suggestions.
  5. The Savings & ROI Engine estimates potential savings.
  6. The AI Consultant answers user questions and explains recommendations.
  7. The dashboard updates dynamically with the latest information.

๐Ÿ“ฆ Prerequisites

Before running the project, ensure the following are installed:

  • Python 3.10+
  • Node.js 18+
  • npm
  • Git

๐ŸŒŸ Future Enhancements

  • IoT Sensor Integration
  • Building Management System (BMS) Integration
  • Predictive Maintenance
  • Renewable Energy Optimization
  • Multi-Building Support
  • Mobile Application
  • Predictive Energy Forecasting
  • Automated Energy Scheduling

๐Ÿค Contributing

Contributions are welcome.

  1. Fork the repository.
  2. Create a new feature branch.
  3. Commit your changes.
  4. Push the branch.
  5. Open a Pull Request.

๐Ÿ‘จโ€๐Ÿ’ป Project Owner

Vaibhav Malviya

GitHub Repository

https://github.com/MalviyaSir/EnergyDecisionAgent

Developed as part of the LTTS Hackathon to demonstrate the application of Agentic AI in intelligent building energy optimization and decision support.


๐Ÿ“œ License

This project is intended for educational, research, demonstration, and hackathon purposes.


โญ Support

If you found this project useful, consider giving the repository a โญ on GitHub.

About

What: An AI-powered Energy Decision Agent for commercial buildings. How: Analyzes sensor and occupancy data to predict consumption and identify waste. Value: Recommends corrective actions to help owners maximize cost savings and improve sustainability.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages