在開始使用 Alpha-Data-Cleaning-Lab 之前，我們需要先準備好它的「大腦」（AI Token）以及「實驗室環境」（Streamlit）。以下是詳細的設定步驟：
1. 取得 AI 的大腦：申請 API Token
這個專案支援多種 AI 模型，你可以根據需求選擇 OpenAI 或 Anthropic (Claude)。- OpenAI (GPT-4o/GPT-4 等)：
- 前往 OpenAI Platform 註冊帳號。
- 點擊 "Create new secret key"，並立即複製保存（金鑰只會顯示一次！）。
- 提醒：帳號內需先儲值（至少 5 美金）API 才能正常運作。
- Anthropic (Claude 3.5 Sonnet 等)：
- 前往 Anthropic Console。
- 在 "Get API Keys" 頁面建立新金鑰。
🔑 申請 Gemini API 金鑰步驟
- 進入 Google AI Studio： 前往 aistudio.google.com，並使用你的 Google 帳號登入。
- 同意服務條款： 如果是第一次進入，系統會要求你閱讀並勾選同意 Google 的服務條款。
- 點擊「Get API key」： 在左側選單（或是上方導覽列）找到 "Get API key" 按鈕。
- 建立金鑰：
- 點擊 "Create API key"。
- 你可以選擇「建立新專案」（Create API key in new project）或是「在現有專案中建立」。
- 註：每個金鑰都必須關聯一個 Google Cloud 專案，如果沒有舊專案，直接選新建即可。
- 複製並保存： 金鑰生成後會顯示一串長代碼。請務必立即複製並妥善保存。為了安全性，請不要將金鑰直接寫在公開的程式碼（如 GitHub）中。
如下圖片可以點選放大
以下名稱自訂
建立好之後點選copy api key 妥善保存 稍後會用到
2. 部署實驗室：Streamlit 設定
本專案是基於 Streamlit 開發的，你可以選擇在「本地執行」或「雲端部署」。
A. 如果你在本地執行 (.env 檔)
在專案根目錄下找到 .env.example，將其重新命名為 .env，並填入你的資訊：
Bash
OPENAI_API_KEY=你的金鑰 ANTHROPIC_API_KEY=你的金鑰
B. 如果你部署在 Streamlit Cloud (Secrets 設定)
這是最推薦的方式，不需開電腦也能隨時使用。
- 將專案 Fork 到你的 GitHub。
- 在 Streamlit Cloud 點擊 "New app" 進行部署。
點選下圖中的Deploy a public app from github
點選要帶入的專案
- 關鍵步驟：在部署頁面點擊 "Advanced settings..."。
在 "Secrets" 區塊中，以 TOML 格式貼入你的變數：
Ini, TOMLOPENAI_API_KEY = "sk-..." ANTHROPIC_API_KEY = "sk-ant-..."
點擊 Save 後，Streamlit 就會自動帶入這些設定。
如果忘了設定變數 之後可以到下圖中畫面點選設定 settings
這repo的環境變數設定如下大部分都是之前有做過教學的
如果覺得圖片太小可以點選圖片後 會出現如下按鈕第二個放大圖片
另外還要建立存放db資料夾的folder_id 共用資料夾id在網址可在下途中取得
然後建立如下變數
💡 進階設定：關於通知系統 (選配)
(這部分就是你提到的，放在文章末端的選配功能)
在環境變數中，你可能會看到 RESEND_API_KEY 或 TELEGRAM_BOT_TOKEN。這屬於「選配」功能，若不設定也不影響核心的數據清理功能。
- Telegram 機器人：適合想在手機收推播的朋友。設定教學如下
- Resend (Email)：適合習慣收信管理的朋友。設定教學如下
🚀 相關連結
- 專案 GitHub 倉庫：https://github.com/grissomlin/Alpha-Data-Cleaning-Lab
- 儀表板網站: 儀表板
