使用说明
🌍 可持续支出仪表板
一个由人工智能驱动的仪表板,可以分析你的消费习惯,估算你的碳足迹,并鼓励做出对气候友好的财务决策 溪流, 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
- 创建虚拟环境
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
- 安装要求
pip install -r requirements.txt
- 添加.env文件 使用以下命令在根文件夹中创建.env文件:
BUNQ_API_KEY=your_bunq_api_key_here
- 🚀 运行应用程序
streamlit run dashboard.py
🌟 示例见解
🌿 你刚刚抵消了25公斤的二氧化碳₂ — 这相当于种了1.2棵树! 💬 你的大部分开支都花在杂货和旅行上。尝试更频繁地骑自行车以减少足迹。 🏦 您已将40欧元转入您的绿色账户。干得好!
🏆 排行榜逻辑
用户按其抵消金额/支出比率进行排名。 当前用户以浅橙色突出显示以便于查看:
比率越高,你对地球的贡献就越好🌎
✅ 可持续发展区逻辑
🟢 绿色:CO₂ 每欧元<0.4→ 杰出的!
🟠 黄色:0.4≤CO₂ 每欧元≤0.6→ 有待改进的空间
🔴 红色:CO₂ 每欧元>0.6→ 考虑更环保的习惯
您的区域在应用程序中显示为动态徽章。
