可持续消费仪表盘

一个AI驱动的仪表盘,分析消费习惯,估算碳足迹,并鼓励气候友好的财务决策。

  • by Rohit8y
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 rohit8y/bunq-hackathon-agents-6.0

使用说明

🌍 可持续支出仪表板

一个由人工智能驱动的仪表板,可以分析你的消费习惯,估算你的碳足迹,并鼓励做出对气候友好的财务决策 溪流, LLM,以及 邦克.

仪表板看起来像这样(很酷!)


💡 它做什么

该仪表板利用LLM的力量将财务数据与气候意识联系起来。它可以帮助您:

  • 了解你的钱去了哪里💸
  • 看看你的支出如何影响地球🌱
  • 通过自动化CO采取气候行动₂ 抵销转账♻️
  • 在可持续发展排行榜上与他人竞争(温和地!)🏆

🧠 技术支持

技术 角色
Streamlit 仪表板UI和交互性
pydantic_ai 代理编排+LLM I/O
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
  1. 创建虚拟环境
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. 安装要求

pip install -r requirements.txt
  1. 添加.env文件 使用以下命令在根文件夹中创建.env文件:
BUNQ_API_KEY=your_bunq_api_key_here
  1. 🚀 运行应用程序
streamlit run dashboard.py

🌟 示例见解

🌿 你刚刚抵消了25公斤的二氧化碳₂ — 这相当于种了1.2棵树! 💬 你的大部分开支都花在杂货和旅行上。尝试更频繁地骑自行车以减少足迹。 🏦 您已将40欧元转入您的绿色账户。干得好!


🏆 排行榜逻辑

用户按其抵消金额/支出比率进行排名。 当前用户以浅橙色突出显示以便于查看:

比率越高,你对地球的贡献就越好🌎


✅ 可持续发展区逻辑

🟢 绿色:CO₂ 每欧元<0.4→ 杰出的!

🟠 黄色:0.4≤CO₂ 每欧元≤0.6→ 有待改进的空间

🔴 红色:CO₂ 每欧元>0.6→ 考虑更环保的习惯

您的区域在应用程序中显示为动态徽章。


创建于💚 在Bunq黑客马拉松期间。