🌍 Sustainable Spending Dashboard

🌍 可持续消费仪表板

一款由 AI 驱动的仪表板，可分析你的消费习惯、估算你的碳足迹，并鼓励你做出有益气候的财务决策——基于 Streamlit、大模型 和 Bunq 构建。

仪表板看起来是这样的（很酷吧！）

---

💡 功能介绍

这款仪表板借助大模型的能力，将财务数据与气候意识相结合。它可以帮助你：

• 了解钱都花到哪里了 💸
• 查看消费对地球的影响 🌱
• 通过自动转账抵消 CO₂ 排放，采取气候行动 ♻️
• 与他人友好地比拼可持续性排行榜 🏆

---

🧠 技术支持

技术	作用
Streamlit	仪表板 UI 和交互功能
pydantic_ai	Agent 编排和大模型输入/输出
Gemini / OpenAI	消费和 CO₂ 推理
Bunq SDK	碳抵消转账
Pandas, Matplotlib	数据处理和图表

---

📂 项目结构

.
├── src/
|   |- dashboard.py # Streamlit dashboard
|   |- bunq_agents.py # Pydantic agents & logic
|   |- mcp_ # MCP servers
|   |- utils/wrapper.py  Bunq integration wrapper
├── data/ 
│ └── transactions.csv # Sample transactions
├── requirements.txt
└── README.md

✨ 功能

✅ 将消费归类到直观的类别中
✅ 计算 CO₂ 排放总量及每消费 € 对应的 CO₂ 排放量
✅ 分配可持续性区域（绿色 / 黄色 / 红色）
✅ 在现代、直观的仪表板中展示洞察
✅ 将抵消金额转入 Bunq 绿色账户 💚
✅ 显示“你种下了 3 棵树！”等激励信息 🌳
✅ 在游戏化排行榜上查看自己的排名 🏆

---

🛠 设置说明

1. 克隆仓库

git clone https://github.com/your-username/bunq-hackathon-agents-6.0.git
cd bunq-hackathon-agents-6.0

2. 创建虚拟环境

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. 安装依赖

pip install -r requirements.txt

4. 添加 .env 文件 在根目录下创建一个 .env 文件，内容如下：

BUNQ_API_KEY=your_bunq_api_key_here

5. 🚀 运行应用

streamlit run dashboard.py

---

🌟 示例洞察

🌿 你刚刚抵消了 25 kg 的 CO₂ 排放——相当于种下了 1.2 棵树！ 💬 你的大部分消费都用于购买杂货和旅行。试着多骑自行车，减少碳足迹。 🏦 你已向绿色账户转入 €40。做得好！

---

🏆 排行榜规则

用户根据抵消金额 / 消费金额比率排名。 当前用户会以浅橙色高亮显示，方便辨认：

比率越高，你为地球做出的贡献就越大 🌎

---

✅ 可持续性区域规则

🟢 绿色：每 € 对应的 CO₂ 排放量 < 0.4 → 非常棒！

🟠 黄色：0.4 ≤ 每 € 对应的 CO₂ 排放量 ≤ 0.6 → 还有提升空间

🔴 红色：每 € 对应的 CO₂ 排放量 > 0.6 → 考虑养成更环保的习惯

你的区域会以动态徽章的形式显示在应用中。

---

在 Bunq Hackathon 期间用 💚 创作。