hasaneyldrm / exercises-dataset

💪 Exercises Dataset A developer setup wizard + structured, multilingual exercise dataset — scaffold your own exercise app backend (DB schema, API code, LLM prompt) over 1,324 exercises with category, body-part, equipment, target and muscle-group data and step-by-step instructions in 6 languages (English, Spanish, Italian, Turkish, Russian, Chinese). Exercise media is not included.

💪 Exercises Dataset（健身动作数据集） 这是一个开发者设置向导及结构化的多语言健身动作数据集。它包含 1,324 个健身动作，涵盖类别、身体部位、器械、目标肌肉群等数据，并提供 6 种语言（英语、西班牙语、意大利语、土耳其语、俄语、中文）的分步说明。该项目旨在帮助开发者快速构建健身应用的后端（包括数据库架构、API 代码及 LLM 提示词）。注意：本项目不包含健身动作的媒体文件。

⚠️ Notice — exercise media is not included This repository is a developer setup wizard and structured exercise dataset. The exercise media (thumbnail images and animation GIFs) is not included here. There are multiple, conflicting ownership claims over this media, so it is not redistributed in this repository. Each record keeps a media_id (the original ExerciseDB media reference); the dataset itself ships exercise metadata and multilingual instruction translations (EN, ES, IT, TR, RU, ZH). If you are the rights holder of this media, please open an issue or contact the maintainer.

⚠️ 注意：不包含健身动作媒体文件 本仓库是一个开发者设置向导和结构化健身动作数据集。健身动作的媒体文件（缩略图和动画 GIF）未包含在内。由于这些媒体存在多方且相互冲突的所有权主张，因此本仓库不进行分发。每条记录保留了一个 media_id（原始 ExerciseDB 的媒体引用）；数据集本身提供健身动作的元数据和多语言说明翻译（英语、西班牙语、意大利语、土耳其语、俄语、中文）。如果您是这些媒体的权利持有人，请提交 Issue 或联系维护者。

📦 Data Source & Attribution The base exercise data in this repository originates from ExerciseDB v1 by AscendAPI (API docs), obtained via a Kaggle re-host by omarxadel. The associated media (images & animation GIFs) is not included in this repository — see the notice above. Each record’s media_id is the original ExerciseDB v1 media id (e.g. 2gPfomN); the official CDN serves the corresponding asset at static.exercisedb.dev/media/{media_id}.gif for anyone entitled to use it.

📦 数据来源与归属 本仓库的基础健身动作数据源自 AscendAPI 的 ExerciseDB v1（API 文档），通过 omarxadel 在 Kaggle 上的重新托管获取。相关的媒体文件（图片和动画 GIF）未包含在本仓库中——请参阅上述说明。每条记录的 media_id 均为原始 ExerciseDB v1 的媒体 ID（例如 2gPfomN）；官方 CDN 在 static.exercisedb.dev/media/{media_id}.gif 提供相应的资源，供有权使用的人员访问。

Added in this repository on top of the base data:

• 🇪🇸 Spanish, 🇮🇹 Italian, 🇹🇷 Turkish, 🇷🇺 Russian, and 🇨🇳 Chinese translations of the instructions
• The interactive browser (index.html) and developer setup guide (setup.html)
• Formatting and cleanup Original-source attribution was added following issue #5 (thanks to @shinkaidev for the report). If you are a rights holder and want anything removed or clarified, please open an issue.

在本仓库中，我们在基础数据之上增加了：

• 🇪🇸 西班牙语、🇮🇹 意大利语、🇹🇷 土耳其语、🇷🇺 俄语和 🇨🇳 中文的动作说明翻译
• 交互式浏览器 (index.html) 和开发者设置指南 (setup.html)
• 数据格式化与清理 原始来源归属已根据 Issue #5 添加（感谢 @shinkaidev 的报告）。如果您是权利持有人并希望删除或澄清任何内容，请提交 Issue。

🔍 Overview This dataset is a curated collection of 1,324 fitness exercises for educational and research purposes. It covers a wide range of muscle groups, equipment types, and exercise categories — making it ideal for:

• Building fitness or workout planning applications
• Machine learning projects involving exercise recognition or recommendation
• Health and wellness research
• Educational demonstrations and prototypes

🔍 概览 该数据集是一个精心整理的健身动作合集，包含 1,324 个动作，旨在用于教育和研究目的。它涵盖了广泛的肌肉群、器械类型和动作类别，非常适合：

• 构建健身或锻炼计划应用程序
• 涉及动作识别或推荐的机器学习项目
• 健康与保健研究
• 教育演示和原型开发

🖥️ Interactive Browser & Developer Setup This repository includes two ready-to-use HTML tools — no server required, just open in a browser. Note: since the media is not bundled, the browser displays exercise metadata and instructions only; thumbnail and GIF slots are empty.

• index.html — Exercise Browser: A fully client-side exercise explorer with live search, filtering, and infinite scroll.
• setup.html — Developer Setup Guide: A step-by-step guide for integrating the dataset, including SQL generation, API integration code, and LLM prompts for backend generation.

🖥️ 交互式浏览器与开发者设置 本仓库包含两个即用型 HTML 工具，无需服务器，直接在浏览器中打开即可。注意：由于未打包媒体文件，浏览器仅显示动作元数据和说明；缩略图和 GIF 槽位为空。

• index.html — 动作浏览器：一个完全基于客户端的动作探索器，支持实时搜索、筛选和无限滚动。
• setup.html — 开发者设置指南：集成数据集的分步指南，包括 SQL 生成、API 集成代码以及用于后端生成的 LLM 提示词。