WattCarbon Analytics

Python toolkit for M&V (Measurement & Verification) analytics using the WattCarbon API.

Features

• API Client: OAuth2-authenticated client for WattCarbon API
• Portfolio Analytics: Asset summaries, savings metrics, geographic distribution
• M&V Audit: Savings verification, data quality audits, methodology review
• Uncertainty Analysis: ASHRAE Guideline 14 / IPMVP statistical analysis
• AI Chatbot: Streamlit app with Claude AI for natural language M&V queries

Installation

pip install -e ".[chatbot]"

Configuration

Create a .env file:

WATTCARBON_EMAIL=your-email@example.com
WATTCARBON_API_KEY=your-api-key
ANTHROPIC_API_KEY=your-anthropic-key  # Optional, for AI chatbot

Usage

Run the M&V Chatbot

streamlit run app.py

Python API

from wattcarbon import WattCarbonClient
from wattcarbon.analytics import PortfolioAnalytics

client = WattCarbonClient()
analytics = PortfolioAnalytics(client)
summary = analytics.get_portfolio_summary()

Project Structure

wattcarbon-analytics/
├── app.py                 # Streamlit chatbot UI
├── wattcarbon/
│   ├── client.py          # WattCarbon API client
│   ├── analytics.py       # Portfolio analytics
│   ├── mv_audit.py        # M&V audit tools
│   ├── uncertainty.py     # Statistical uncertainty analysis
│   ├── chatbot.py         # Basic chat engine
│   └── ai_chatbot.py      # Claude AI-powered chatbot
└── examples/
    └── portfolio_analysis.py

License

Proprietary - WattCarbon