README.md

---
title: Global SDG Tracker AI
emoji: 🌍
colorFrom: blue
colorTo: green
sdk: streamlit
app_port: 7860
---

# Global SDG Tracker AI (2025 Edition) 🌍

<div align="center">

![SDG Tracker](https://upload.wikimedia.org/wikipedia/commons/d/df/UN_Sustainable_Development_Goals_logo.png)

**全球最專業的 2025 聯合國永續發展目標 (SDG) AI 驅動分析儀表板**

[即時演示](https://huggingface.co/spaces/song/global-sdg-tracker-ai) • [技術文檔](#使用說明) • [SDSN 數據源](https://dashboards.sdgindex.org/)

</div>

## 🌟 2025 重大升級亮點

本專案已全面升級至 **Sustainable Development Report 2025** 最新數據，對標官方 SDSN 標準，並整合了 2025 年最強大的 AI 模型。

- **📅 最新數據**: 涵蓋 2000-2025 年全球 193 個國家的最新 SDG 績效。
- **📈 趨勢指標**: 每個目標現在都附帶 2025 年趨勢箭頭（↑、→、↓）。
- **🤖 2025 AI 引擎**: 支持 Gemini 2.0 Pro、Claude 3.5 Sonnet 與 GPT-4o，提供深度策略分析。
- **⚡ 視覺化優化**: 採用 2025 年最新配色與互動地圖，支持單個國家的 KPI 增量分析。
- **📥 專業匯出**: 全面優化 PDF、PowerPoint 與 CSV 的數據匯出品質。

---

## 📖 專案簡介

Global SDG Tracker AI 是一個開源的研究級工具，旨在幫助政策制定者、研究人員與環保人士快速掌握全球永續發展動態。透過 AI 技術，將冰冷的數據轉化為具備前瞻性的行動建議。

### ✨ 核心功能

- **📊 2025 全球視覺化**: 互動式世界地圖，即時展示各國 SDG 指數排名。
- **🌏 區域深度剖析**: 支持對比國家與全球平均值的差距（Performance vs Avg）。
- **🤖 戰略報告生成**: AI 自動分析 Top 3 亮點與 Top 3 挑戰，並給出 2030 年預測情境。
- **📉 多維度趨勢**: 支持 2000-2025 年多目標趨勢疊加分析。
- **📱 行動優先設計**: 全新的 CSS 框架，完美兼容手機與平板瀏覽。

## 🤖 AI 配置指南

本專案支援多種 AI 模型，預設為 **Mock Mode**。若要啟用真實 AI 功能，請依照以下步驟設定：

1. **環境變數設定**:
   在專案根目錄建立 `.env` 檔案：
   ```env
   LITELLM_BASE_URL=https://api.openai.com/v1
   LITELLM_API_KEY=your_api_key_here
   ```
2. **支援模型**:
   - `gemini-2.5-flash` (預設)
   - `gpt-4o`
   - `claude-3-sonnet`
   透過「⚙️ 配置管理」選單可即時切換模型。

## 🚀 快速啟動

### 方式一：HuggingFace 快速部署 (推薦)

1. Fork 本倉庫到您的 GitHub。
2. 在 HuggingFace Spaces 創建新空間，選擇 **Docker** SDK。
3. 連接倉庫，並設定 `LITELLM_API_KEY` 與 `LITELLM_BASE_URL` 環境變數。

### 方式二：本地開發

```bash
# 克隆專案
git clone https://github.com/your-username/global-sdg-tracker-ai.git
cd global-sdg-tracker-ai

# 安裝依賴
pip install -r requirements.txt

# 運行開發伺服器
streamlit run app.py
```

## 📋 數據來源與引用

本專案數據主要來源於：
> Sachs, J.D., et al. (2025). **Sustainable Development Report 2025**. Sustainable Development Solutions Network (SDSN).

**數據授權**: 所有原始數據遵循 SDSN 開放數據協議。

## 🔧 技術棧

- **Frontend**: Streamlit (Latest version with custom CSS system)
- **Data Engine**: Pandas & NumPy (Optimized for 2025 schemas)
- **Viz Engine**: Plotly Express & GraphObjects
- **AI Hub**: LiteLLM (Supporting Gemini 2.0, GPT-4, Claude 3.5)
- **Export System**: Python-pptx & FPDF2

## 📞 聯絡與支援

- **開發者**: Senior AI & Environmental Systems Engineer
- **GitHub**: [https://github.com/your-username/global-sdg-tracker-ai](https://github.com/your-username/global-sdg-tracker-ai)
- **Star & Support**: 如果本專案對您有幫助，請給我們一個 ⭐️！
- **📧 技術支援**: 請通過 GitHub Issues 聯繫

---

<div align="center">

**🌟 如果這個專案對您有幫助，請給我們一個星標！**

[⬆ 回到頂部](#global-sdg-tracker-ai)

</div>