DeepLearning101 commited on
Commit
c8880b8
·
verified ·
1 Parent(s): 7b32bc8

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +21 -24
README.md CHANGED
@@ -19,7 +19,8 @@ short_description: 'Status code 404: Professor is in another dimension.'
19
 
20
  👉 歡迎 Star ⭐ GitHub 👆 👆 HuggingFace ⭐ 覺得不錯 👈
21
 
22
- **學術研究啟程的導航系統,拒絕當科研路上的無頭蒼蠅 🪰**
 
23
 
24
  [立即體驗 (Hugging Face)](https://huggingface.co/spaces/DeepLearning101/Prof.404) | [Deep Learning 101](https://deep-learning-101.github.io/)
25
 
@@ -34,7 +35,7 @@ short_description: 'Status code 404: Professor is in another dimension.'
34
 
35
  **Prof.404** 是一個基於 Google Gemini 模型的 **學術雷達**。它不只是搜人,更是你的科研情報官:
36
 
37
- * 🚀 **科研人員/開發者**:想知道台灣誰在做最新的「後量子密碼」或「具身智能」或「擴散模型」?別再一篇篇翻系所網頁了,AI 直接幫你盤點戰力。
38
  * 🤝 **產業界/企業主**:想找教授做產學合作、技術顧問?這裡能幫你分析教授的實戰經驗與過往產學績效。
39
  * 🎓 **準研究生**:選指導教授就像選對象,適不適合很重要。這裡提供客觀的研究方向與畢業生出路分析,作為你的選組參考。
40
 
@@ -63,7 +64,7 @@ short_description: 'Status code 404: Professor is in another dimension.'
63
  我們提供兩種方案,不管你是 Google Sheet 的信徒,還是 Python 的狂熱者,都能輕鬆上手。
64
 
65
  ### 方案 A:Google Apps Script (GAS) 版
66
- **特色:免費、免伺服器、結合 Google Sheet 自動存檔(超方便!)**
67
 
68
  1. 建立一個新的 [Google Apps Script](https://script.google.com/) 專案。
69
  2. **複製程式碼**:
@@ -72,47 +73,43 @@ short_description: 'Status code 404: Professor is in another dimension.'
72
  3. **設定環境變數** (專案設定 -> 指令碼屬性):
73
  * `GEMINI_API_KEY`: 你的 Google Gemini API Key。
74
  * `SPREADSHEET_ID`: 建立一個 Google Sheet,把網址 `d/` 後面的 ID 貼過來(AI 幫你搜集的資料會自動存進去!)。
75
- * `GEMINI_MODEL_ID`: (選填) 例如 `gemini-2.5-flash`。
76
  4. **執行權限驗證**:在編輯器手動執行一次 `getSheet` 函式,同意權限。
77
  5. **發布**:點擊「部署」->「新增部署」->「網頁應用程式」->「建立新版本」-> 完成!
78
 
79
  ### 方案 B:Hugging Face Space (Python/Gradio) 版
80
- **特色:介面美觀、一鍵 Fork、支援 Python 生態**
81
 
82
- 1. **Fork 專案**:直接到我們的 Space 點擊右上角的 **Duplicate this Space**。
 
 
83
  * 👉 [DeepLearning101/Prof.404](https://huggingface.co/spaces/DeepLearning101/Prof.404)
84
- 2. **設定 Secret**:
85
- * 進入 Space 的 `Settings` -> `Variables and secrets` -> `Secrets`。
86
- * 新增 `GEMINI_API_KEY`: 必填:Gemini API 金鑰。
87
- * 新增 `GEMINI_MODEL_ID`: 選填:模型版本 (改這裡就不需要改程式碼)。
88
- * 新增 `SAVE_FILE_NAME`: 選填:存檔檔名 (如果你想連這個都設定的話)
89
-
90
- 3. **搞定**:Space 會自動 Build,幾分鐘後就能用了!
91
-
92
- *(小提醒:HF Space 免費版重啟後資料會重置,若要永久存檔建議使用 GAS 版或自行串接資料庫)*
93
 
94
  ---
95
 
96
  ## 🛠️ 本地開發 (Local Development)
97
 
98
- 如果你想在自己電腦上魔改這個專案:
99
 
100
  ```bash
101
  # 1. Clone 專案
102
- git clone https://github.com/Deep-Learning-101/prof-404.git
103
  cd prof-404
104
 
105
  # 2. 安裝依賴
106
  pip install -r requirements.txt
107
 
108
  # 3. 設定 .env
109
- # 建立 .env 檔案並填入:
110
- # 必填:Gemini API 金鑰
111
- # GEMINI_API_KEY=你的_AIza_��頭的金鑰
112
- # 選填:模型版本 (改這裡就不需要改程式碼)
113
- # GEMINI_MODEL_ID=gemini-2.5-flash
114
- # 選填:存檔檔名 (如果你想連這個都設定的話)
115
- # SAVE_FILE_NAME=saved_professors.json
116
 
117
  # 4. 啟動 Gradio
118
  python app.py
 
19
 
20
  👉 歡迎 Star ⭐ GitHub 👆 👆 HuggingFace ⭐ 覺得不錯 👈
21
 
22
+ **學術研究啟程的導航系統,拒絕當科研路上的無頭蒼蠅**
23
+ **(全新升級:支援雲端同步!HuggingFace Space 重啟資料不遺失 🔄)**
24
 
25
  [立即體驗 (Hugging Face)](https://huggingface.co/spaces/DeepLearning101/Prof.404) | [Deep Learning 101](https://deep-learning-101.github.io/)
26
 
 
35
 
36
  **Prof.404** 是一個基於 Google Gemini 模型的 **學術雷達**。它不只是搜人,更是你的科研情報官:
37
 
38
+ * 🚀 **科研人員/開發者**:想知道台灣誰在做最新的「後量子密碼」或「具身智能」?別再一篇篇翻系所網頁了,AI 直接幫你盤點戰力。
39
  * 🤝 **產業界/企業主**:想找教授做產學合作、技術顧問?這裡能幫你分析教授的實戰經驗與過往產學績效。
40
  * 🎓 **準研究生**:選指導教授就像選對象,適不適合很重要。這裡提供客觀的研究方向與畢業生出路分析,作為你的選組參考。
41
 
 
64
  我們提供兩種方案,不管你是 Google Sheet 的信徒,還是 Python 的狂熱者,都能輕鬆上手。
65
 
66
  ### 方案 A:Google Apps Script (GAS) 版
67
+ **特色:免費、免伺服器、結合 Google Sheet 自動存檔(最簡單!)**
68
 
69
  1. 建立一個新的 [Google Apps Script](https://script.google.com/) 專案。
70
  2. **複製程式碼**:
 
73
  3. **設定環境變數** (專案設定 -> 指令碼屬性):
74
  * `GEMINI_API_KEY`: 你的 Google Gemini API Key。
75
  * `SPREADSHEET_ID`: 建立一個 Google Sheet,把網址 `d/` 後面的 ID 貼過來(AI 幫你搜集的資料會自動存進去!)。
76
+ * `GEMINI_MODEL_ID`: (選填) 例如 `gemini-2.0-flash`。
77
  4. **執行權限驗證**:在編輯器手動執行一次 `getSheet` 函式,同意權限。
78
  5. **發布**:點擊「部署」->「新增部署」->「網頁應用程式」->「建立新版本」-> 完成!
79
 
80
  ### 方案 B:Hugging Face Space (Python/Gradio) 版
81
+ **特色:介面美觀、一鍵 Fork、支援雲端同步 (資料不遺失)**
82
 
83
+ 1. **準備雲端資料庫** (若不需雲端存檔可跳過):
84
+ * 到 HF 建立一個新的 **Dataset** (建議設為 Private),記下 ID (如 `YourName/prof-data`)。
85
+ 2. **Fork 專案**:直接到我們的 Space 點擊右上角的 **Duplicate this Space**。
86
  * 👉 [DeepLearning101/Prof.404](https://huggingface.co/spaces/DeepLearning101/Prof.404)
87
+ 3. **設定 Secret** (Settings -> Variables and secrets -> Secrets):
88
+ * `GEMINI_API_KEY`: **(必填)** Gemini API 金鑰。
89
+ * `HF_TOKEN`: **(選填)** 你的 HF Access Token (需有 Write 權限),用於同步資料。
90
+ * `DATASET_REPO_ID`: **(選填)** 步驟 1 建立的 Dataset ID (例如 `DeepLearning101/prof-data`)。
91
+ * `GEMINI_MODEL_ID`: (選填) 預設 `gemini-2.0-flash`。
92
+ 4. **搞定**:Space 會自動 Build。設定好 `HF_TOKEN` 後,**即使 Space 重啟,你的追蹤清單也會自動從 Dataset 還原!**
 
 
 
93
 
94
  ---
95
 
96
  ## 🛠️ 本地開發 (Local Development)
97
 
98
+ 如果你想在自己電腦上魔改這個專案,甚至實現「本地跑程式、雲端存資料」:
99
 
100
  ```bash
101
  # 1. Clone 專案
102
+ git clone [https://github.com/Deep-Learning-101/prof-404.git](https://github.com/Deep-Learning-101/prof-404.git)
103
  cd prof-404
104
 
105
  # 2. 安裝依賴
106
  pip install -r requirements.txt
107
 
108
  # 3. 設定 .env
109
+ # 建立 .env 檔案並填入 (HF_TOKEN 設了就能跟你的 Space 同步資料!):
110
+ # GEMINI_API_KEY=你的Key
111
+ # HF_TOKEN=你的HF_Write_Token (選填,填了就能同步雲端!)
112
+ # DATASET_REPO_ID=你的Dataset_ID (選填)
 
 
 
113
 
114
  # 4. 啟動 Gradio
115
  python app.py