README.md

---
title: "Climate Clock Observatory"
emoji: 🌍
colorFrom: green
colorTo: blue
sdk: streamlit
sdk_version: "1.32.0"
app_file: app.py
pinned: false
---

# 🌍 Climate Clock Observatory

This Streamlit app visualizes real-time climate indicators using the [Climate Clock API](https://docs.climateclock.world/climate-clock-docs/climate-clock-api). It is built as part of a final project to demonstrate how data can be transformed into an engaging and informative climate observatory.

## 📊 Visualizations Included

1. **CO₂ Budget Depletion Projection** – 10-year forecast using current depletion rates.
2. **Global Energy Mix** – A donut chart showing the percentage of global energy from renewables.
3. **Lifeline Metrics** – A bar chart showing positive contributions like trees planted and energy created.
4. **Time Until 1.5°C Breach** – Countdown clock showing years, months, and days remaining.
5. **CO₂ Budget Simulator** – Interactive slider that simulates reduced emissions and updates the budget timeline.

## 🚀 How to Run

```bash
pip install -r requirements.txt
streamlit run app.py
```

## 🛠️ Tech Stack

- Streamlit
- Altair
- Pandas
- Climate Clock API

## 👥 Contributors

Sanidhya and Group Members

## 📝 Notes

- All plots are created using Altair as per project guidelines.
- The app uses a refresh-button-friendly design and pseudo real-time data.

Enjoy exploring our climate observatory!