How muhil-amuthan/carbonwise works
CarbonWise is a Streamlit advisor that estimates grid carbon intensity and helps users choose lower-emission appliance run times. Its documented workflow accepts generation-mix or CSV data, estimates intensity, presents visualizations and recommendations, and supports summary reporting. The main application is a large monolith; the sampled excerpts show its external API calls, while README workflow statements support the broader product stages. The excerpts do not establish that app.py calls the separate src modules, so those links are omitted.
Main entry points: app.py Streamlit interface · ci.py Intensity estimate · recommend.py Window ranking · io_utils.py Run log
Components 11
Web application
- Streamlit interface
app.py
Carbon analysis
- Mix and CSV input
app.py - Intensity estimate
src/ci.py - Window ranking
src/recommend.py - Recommendations
app.py - Grid visualizations
app.py
Run records
- Run log
src/io_utils.py
Reporting
- Summary report
generate_summary.py
Other components
- User
- Electricity Maps API
- IP location API
Connections 11
- User → Streamlit interface: uses
README.md - Streamlit interface → Electricity Maps API: requests intensity
app.py - Streamlit interface → IP location API: looks up location
app.py - Streamlit interface → Mix and CSV input: accepts data
README.md - Mix and CSV input → Intensity estimate: feeds calculation
README.md - Intensity estimate → Grid visualizations: displays estimate
README.md - Intensity estimate → Window ranking: ranks lower-carbon windows
- Window ranking → Recommendations: returns ranked windows
README.md - Streamlit interface → Grid visualizations: renders results
README.md - Streamlit interface → Run log: records runs
- Run log → Summary report: supplies run data