GitHub Trending 榜首:exercises-dataset

一个面向健身应用开发者的结构化多语言训练动作数据集,涵盖 1,324 个健身动作记录,支持六种语言的教学指令,并附带交互式浏览器与开发者设置向导。

项目地址https://github.com/hasaneyldrm/exercises-dataset
今日 Stars:7,671 | Forks:889 | 主要语言:HTML

项目简介

exercises-dataset 是今日 GitHub Trending 榜首项目,由 hasaneyldrm 维护。它是一个面向健身应用开发者、机器学习研究者和健康领域创作者的结构化训练动作数据集。仓库目前收录了 1,324 个健身动作记录,每条记录都包含动作名称、身体部位分类、目标肌群、所需器械、分步骤训练说明,以及英文、西班牙文、意大利文、土耳其文、俄文和中文共 六种语言 的教学指令。

该项目的数据底层源自 ExerciseDB v1(由 AscendAPI 提供),并在此基础上补充了多语言翻译、交互式浏览器和开发者设置向导,使其成为一个“开箱即用”的健身数据基础设施。

核心特性

  • 大规模结构化数据:1,324 条动作记录,覆盖上肢、下肢、背部、胸部、肩部、腰腹、有氧等全身训练场景。
  • 多语言支持:教学指令已翻译为 EN / ES / IT / TR / RU / ZH,便于构建全球化健身应用。
  • 无需服务器的交互工具index.html 可直接在浏览器中打开,支持实时搜索、分类筛选、无限滚动和详情查看。
  • 开发者设置向导setup.html 提供数据库建表语句(SQL Server、PostgreSQL、MySQL、SQLite)、多语言 API 调用示例(JS、Python、C#、Java、PHP、Go、cURL),以及可粘贴到 ChatGPT / Claude / Gemini 的结构化提示词,帮助快速生成 Express.js、FastAPI、ASP.NET Core、Spring Boot、Laravel、Gin 后端。
  • 居家健身友好:约 25% 的动作仅需自重,无需器械。

数据Schema

每条记录包含以下字段:

字段 说明
id 唯一数字编号,如 "0001"
name 动作完整名称
category / body_part 目标身体部位
equipment 所需器械,body weight 表示自重
instructions.{lang} 六种语言的分步骤说明
target 主要目标肌群
muscle_group / secondary_muscles 主动肌与协同肌
media_id 原始 ExerciseDB 媒体引用 ID(图片/GIF 不随仓库分发)

使用示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
import json

with open("data/exercises.json", "r", encoding="utf-8") as f:
    exercises = json.load(f)

# 筛选胸部训练动作
chest = [ex for ex in exercises if ex["category"] == "chest"]
print(f"Chest exercises: {len(chest)}")  # 163

# 读取中文说明
print(exercises[0]["instructions"]["zh"])

注意事项

仓库仅提供训练动作元数据和多语言文本,不包含缩略图与动画 GIF。媒体文件因存在版权争议未在仓库中重新分发,但每条记录保留了原始 media_id,开发者可依据授权情况自行对接 ExerciseDB 官方 CDN。

适合场景

  • 健身 / 训练计划类 App 后端数据层
  • 动作识别、推荐系统相关的机器学习项目
  • 健康与运动领域的研究原型
  • 多语言内容聚合与知识库构建

如果你正在寻找一个干净、结构化、带有多语言支持的健身数据集来快速启动项目,exercises-dataset 是一个值得关注的 Trending 项目。