hasaneyldrm/exercises-dataset

A comprehensive dataset of 433 fitness exercises. Each entry includes name, category, target muscle group, equipment, instructions, thumbnail image, and animation video.

這是什麼

hasaneyldrm/exercises-dataset 是一份面向開發者的健身動作資料集與整合精靈。README 把它定位成可用來搭建健身 App 後端的素材包：核心資料放在 data/exercises.json，包含 1,324 個運動動作，每筆資料有名稱、身體部位／分類、器材、目標肌群、輔助肌群、分步說明，以及英文、西班牙文、義大利文、土耳其文、俄文、中文共 6 種語言的指令。它不只是丟一份 JSON，還附了 index.html 的純前端瀏覽器，以及 setup.html 的資料庫匯入、API 範例與 LLM 產生後端提示詞。

為什麼上榜

這個專案今天以 6,538 stars、單日新增 1,343 stars 衝上日榜，亮點在於它抓住了「資料集 + 可落地開發範本」的需求。很多健身資料集只提供原始欄位，這個 repo 則把資料瀏覽、DB schema、API client 範例、甚至丟給 ChatGPT／Claude／Gemini 產生 REST API 的提示都包在一起，讓開發者更容易把資料變成產品雛形。另一個必須注意的重點是：README 明確聲明不包含縮圖與 GIF 動畫媒體，原因是媒體所有權主張有衝突；資料內只保留 media_id 作為原 ExerciseDB media reference。

適合誰，可以拿來做什麼

它最適合想做健身 App、訓練菜單規劃、推薦系統、健康教育原型的人。若你需要的是結構化、可搜尋、可匯入資料庫的動作資料，這份 JSON 很快就能派上用場；若你想做完整圖文影音展示，則要另外處理媒體授權與素材來源。README 也提到約 25% 動作不需器材，所以對居家訓練、零器材訓練或入門型 workout planner 特別友善。上手門檻偏低：資料是 JSON，瀏覽器與 setup guide 都是靜態 HTML，不需要先架伺服器。

上手

README 的最小上手方式很直接：下載專案後使用資料檔，或直接打開靜態頁面瀏覽。

exercises-dataset/
├── data/exercises.json
├── index.html
├── setup.html
└── README.md

若要在程式中使用，README 示範用 JSON 載入 data/exercises.json，再依 category、equipment 等欄位過濾；也提供 Pandas 範例做分類統計。若要整合到後端，setup.html 可在瀏覽器中產生 SQL Server、PostgreSQL、MySQL、SQLite 的建表與 INSERT，並提供 JavaScript、Python、C#、Java、PHP、Go、cURL 的 API 呼叫範例。

README 重點摘要

• 資料集含 1,324 個運動動作，欄位涵蓋分類、器材、目標肌群、輔助肌群與逐步說明。
• 指令支援 6 種語言：英文、西班牙文、義大利文、土耳其文、俄文、中文。
• index.html 是純前端動作瀏覽器，可搜尋、依分類／器材／目標肌群篩選，並查看多語說明。
• setup.html 提供資料庫匯入、API client 範例，以及可貼給 LLM 生成 REST API 的結構化提示。
• README 特別強調媒體不隨 repo 發布：image 與 gif_url 為 null，僅保留 media_id，使用者需自行確認媒體權利。