🌍 Sustainable Spending Dashboard

🌍 サステナブル支出ダッシュボード

支出習慣を分析し、カーボンフットプリントを推定して、気候に配慮した金融上の選択を促す AI 搭載ダッシュボードです。Streamlit、LLMs、Bunq を使用して構築されています。

ダッシュボードはこんな感じです（かっこいいですよね！）

---

💡 できること

このダッシュボードは、LLMs の力を活用して金融データと気候への意識を結び付けます。次のことに役立ちます。

• お金の使い道を把握する 💸
• 支出が地球に与える影響を確認する 🌱
• CO₂ オフセットの自動送金を通じて気候変動対策に取り組む ♻️
• サステナビリティのリーダーボードでほかのユーザーと（気軽に！）競い合う 🏆

---

🧠 使用技術

技術	役割
Streamlit	ダッシュボード UI とインタラクティブ機能
pydantic_ai	エージェントのオーケストレーションと LLM の入出力
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₂ 排出量の合計と、支出 1 € あたりの CO₂ 排出量を計算する
✅ サステナビリティゾーン（Green / Yellow / Red）を割り当てる
✅ モダンで直感的なダッシュボードで分析結果を可視化する
✅ オフセット額を 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

---

🌟 分析結果の例

🌿 CO₂ を 25 kg オフセットしました。木を 1.2 本植えたのと同じ効果です！ 💬 支出の大半は食料品と旅行に使われています。カーボンフットプリントを減らすために、もっと自転車を利用してみましょう。 🏦 グリーン口座に €40 を送金しました。いいですね！

---

🏆 リーダーボードの仕組み

ユーザーはオフセット額／支出額の比率で順位付けされます。 現在のユーザーは見やすいように薄いオレンジ色で強調表示されます。

比率が高いほど、地球のためにより良い取り組みができています 🌎

---

✅ サステナビリティゾーンの仕組み

🟢 Green：CO₂／€ < 0.4 → すばらしい！

🟠 Yellow：0.4 ≤ CO₂／€ ≤ 0.6 → 改善の余地があります

🔴 Red：CO₂／€ > 0.6 → もっと環境に配慮した習慣を検討しましょう

アプリでは、ゾーンが動的なバッジとして表示されます。

---

Bunq Hackathon で 💚 を込めて作成されました。