개발자 설정 위저드 + 구조화된 다국어 운동 데이터셋 — 카테고리, 신체 부위, 장비, 타겟 및 근육 그룹 데이터와 6개 언어(영어, 스페인어, 이탈리아어, 터키어, 러시아어, 중국어)로 된 단계별 지침을 포함한 1,324개의 운동 데이터를 기반으로 자신만의 운동 앱 백엔드(DB 스키마, API 코드, LLM 프롬프트)를 구축해 보세요. 운동 미디어는 포함되어 있지 않습니다.

이 저장소는 개발자 설정 위저드(setup wizard) 및 구조화된 운동 데이터셋입니다. 운동 미디어(썸네일 이미지 및 애니메이션 GIF)는 여기에 포함되어 있지 않습니다. 이 미디어에 대해 여러 상충하는 소유권 주장이 존재하므로, 이 저장소에는 재배포되지 않습니다. 각 레코드는 media_id(원본 ExerciseDB 미디어 참조)를 유지합니다. 데이터셋 자체에는 운동 메타데이터와 다국어 지침 번역(EN, ES, IT, TR, RU, ZH)이 포함되어 있습니다.

만약 귀하가 이 미디어의 권리 소유자라면, 이슈(issue)를 생성하거나 유지 관리자에게 연락해 주시기 바랍니다.

이 저장소의 기본 운동 데이터는 omarxadel이 Kaggle에 재호스팅한 AscendAPI의 ExerciseDB v1(API 문서)에서 유래되었습니다.

관련 미디어(이미지 및 애니메이션 GIF)는 이 저장소에 포함되어 있지 않습니다 — 위의 공지 사항을 참조하십시오. 각 레코드의 media_id는 원본 ExerciseDB v1 미디어 ID(예: 2gPfomN)입니다. 사용 권한이 있는 사람이라면 누구나 공식 CDN을 통해 static.exercisedb.dev/media/{media_id}.gif에서 해당 에셋을 이용할 수 있습니다.

기본 데이터에 이 저장소에서 추가된 사항:

• 지침에 대한 🇪🇸 스페인어, 🇮🇹 이탈리아어, 🇹🇷 터키어, 🇷🇺 러시아어 및 🇨🇳 중국어 번역
• 인터랙티브 브라우저(index.html) 및 개발자 설정 가이드(setup.html) - 포맷팅 및 정리

이슈 #5에 따라 원본 소스 출처 표기가 추가되었습니다(보고해 주신 @shinkaidev 님께 감사드립니다). 귀하가 권리 소유자로서 삭제 또는 명확한 설명을 원하신다면 이슈를 생성해 주시기 바랍니다.

• 데이터 소스 및 출처 (Data Source & Attribution)
• 개요 (Overview)
• 대화형 브라우저 및 개발자 설정 (Interactive Browser & Developer Setup)
• 파일 구조 (File Structure)
• 통계 (Statistics)
• 데이터 스키마 (Data Schema)
• 샘플 운동 (Sample Exercises)
• 사용 예시 (Usage Examples)
• 라이선스 및 사용 (License & Use)

이 데이터셋은 교육 및 연구 목적으로 큐레이션된 1,324개의 피트니스 운동 (fitness exercises) 컬렉션입니다. 다양한 근육 그룹, 장비 유형 및 운동 카테고리를 다루고 있어 다음과 같은 용도에 이상적입니다:

• 피트니스 또는 운동 계획 애플리케이션 구축
• 운동 인식 또는 추천을 포함하는 머신러닝 (Machine learning) 프로젝트
• 건강 및 웰니스 연구
• 교육용 시연 및 프로토타입

각 운동 항목은 다음을 포함합니다:

필드 (Field)	설명 (Description)
고유 ID (Unique ID)	숫자 식별자 (예: "0001" )
...

이 저장소(repository)에는 즉시 사용할 수 있는 두 가지 HTML 도구가 포함되어 있습니다. 서버는 필요하지 않으며, 브라우저에서 바로 열 수 있습니다.

참고: 미디어 파일이 포함되어 있지 않으므로, 브라우저에는 운동 메타데이터 (metadata)와 지침 (instructions)만 표시되며, 썸네일 및 GIF 슬롯은 비어 있습니다.

다음 기능을 갖춘 완전한 클라이언트 측 (client-side) 운동 탐색기:

• 1,324개 전체 운동에 대한 실시간 검색
• 카테고리, 장비 및 타겟 근육별 필터링
• 무한 스크롤 그리드 (Infinite scroll grid)
• 카드를 클릭하여 영어, 스페인어, 이탈리아어, 터키어, 러시아어 또는 중국어로 된 전체 상세 정보 및 지침 확인

데이터셋을 귀하의 애플리케이션에 통합하기 위한 단계별 가이드:

데이터베이스 설정 (Database Setup)—CREATE TABLE

SQL Server, PostgreSQL, MySQL 및 SQLite용 SQL을 제공합니다. 브라우저에서 완전히 생성되는 1,324개의 모든 INSERT 문이 포함된 즉시 실행 가능한 .sql 파일을 생성하세요.

API 통합 (API Integration)— 백엔드 API를 호출하는 방법을 보여주는 JavaScript, Python, C#, Java, PHP, Go 및 cURL 클라이언트 코드를 복사하여 붙여넣으세요. 기본 URL(base URL)을 입력하면 모든 예시가 실시간으로 업데이트됩니다.

LLM에게 질문하기 (Ask Your LLM)— ChatGPT, Claude 또는 Gemini에 붙여넣어 한 번에 완전한 프로덕션 준비 완료된 REST API를 생성할 수 있는 구조화된 프롬프트(프레임워크 + 데이터베이스 선택)를 제공합니다. Express.js, FastAPI, ASP.NET Core, Spring Boot, Laravel 및 Gin을 지원합니다.

exercises-dataset/
├── data/
│ └── exercises.json # 전체 데이터셋 — 1,324개의 운동 기록 (JSON 배열)
...

— 주 데이터 파일. 모든 메타데이터를 포함하는 1,324개 운동 객체의 JSON 배열입니다. data/exercises.json

image

및 gif_url 필드는 null이며, media_id는 원본 ExerciseDB 미디어 참조를 담고 있습니다.— 독립형 운동 브라우저. 모든 최신 브라우저에서 직접 열 수 있습니다. index.html

— DB 설정, API 통합 및 LLM 지원 백엔드 생성을 위한 개발자 가이드입니다. setup.html

미디어(images/, videos/)는 의도적으로 이 저장소의 일부가 아닙니다 — 공지 사항을 참조하십시오.

지표 (Metric)	개수 (Count)
총 운동 수 (Total Exercises)	1,324
설명 언어 (Instruction Languages)	6

신체 부위 (Body Part)	운동 수 (Exercise Count)
상완 (Upper Arms)	292
...
장비 (Equipment)	운동 수 (Exercise Count)
---	---
체중 (Body Weight)	325
...

참고: 운동의 약 25%는 아무런 장비가 필요하지 않아 집에서 하는 운동 애플리케이션에 적합합니다.

data/exercises.json의 각 기록은 다음 구조를 따릅니다:

| 필드 (Field) | 타입 (Type) | 설명 (Description) |
|---|---|
| id | string | 고유 숫자 식별자 (예: `

"dumbbell", "body weight") |
instructions.en | string | 영어로 된 전체 단계별 지침 |
instructions.es | string | 스페인어로 된 전체 단계별 지침 |
instructions.it | string | 이탈리아어로 된 전체 단계별 지침 |
instructions.tr | string | 터키어로 된 전체 단계별 지침 |
instructions.ru | string | 러시아어로 된 전체 단계별 지침 |
instructions.zh | string | 중국어로 된 전체 단계별 지침 |
muscle_group | string | 주요 협력근 (Synergist) 근육군 |
secondary_muscles | array[string] | 관여하는 추가 근육 |
target | string | 주요 타겟 근육 (예: "biceps", "pectoralis major") |
media_id | string | 원본 ExerciseDB 미디어 참조 ID (예: "2gPfomN") — 미디어는 포함되지 않음 |
image | null | 썸네일 경로를 위해 예약됨; null (미디어 미포함) |
gif_url | null | 애니메이션 경로를 위해 예약됨; null (미디어 미포함) |
created_at | string | 레코드 생성의 ISO 8601 타임스탬프 |

{
"id": "0001",
"name": "3/4 sit-up",
...

미디어는 포함되지 않으며 (공지 사항 참조); 각 예시의 media_id가 참조용으로 표시됩니다.

장비: 바벨(Barbell) · 타겟: 대흉근(Pectorals) · 보조: 삼두근(Triceps), 어깨(Shoulders) · 미디어 ID: EIeI8Vf

바벨 벤치 프레스(Barbell Bench Press)는 가슴 운동의 초석이자 파워리프팅의 "Big Three" 동작 중 하나입니다. 벤치에 평평하게 누워 무게가 실린 바벨을 가슴까지 내렸다가 폭발적으로 다시 밀어 올립니다. 이 동작은 대흉근, 삼두근, 전면 삼각근(Anterior deltoids)을 동시에 동원하여, 상체 밀기 근력과 가슴 근육량 발달을 위한 가장 효과적인 단일 운동이 됩니다.

핵심 큐(Key cues): 바벨을 랙에서 빼기 전에 견갑골(Scapulae)을 후인(Retract) 및 하강(Depress)시키세요. 발은 바닥에 평평하게 붙이고, 허리 아치(Arch)를 자연스럽게 유지하며, 어깨너비의 그립을 유지하세요. 바를 통제하며 가슴 중앙까지 내린 후 뒤꿈치를 통해 밀어 올리세요.

장비: 바벨(Barbell) · 타겟: 둔근(Glutes) · 보조: 햄스트링(Hamstrings), 하부 요추(Lower Back) · 미디어 ID: ila4NZS

바벨 데드리프트(Barbell Deadlift)는 궁극적인 전신 근력 운동으로 널리 간주됩니다. 이 운동은 둔근(Glutes), 햄스트링(Hamstrings), 하부 요추(Lower Back)를 포함하여 후면 사슬(Posterior Chain)의 거의 모든 주요 근육을 참여시키는 동시에, 상부 등(Upper Back), 승모근(Traps), 그리고 악력(Grip)의 상당한 기여를 요구합니다. 수행 능력과 안전 모두를 위해 적절한 척추 정렬(Spinal Alignment)과 브레이싱(Bracing) 기술이 매우 중요합니다.

핵심 큐(Key cues): 바벨이 발등 중간(Mid-foot) 위에 오도록 셋업합니다. 고관절(Hips)을 접고(Hinge), 다리 바로 바깥쪽을 잡으며, 코어(Core)를 강하게 브레이싱하고, 리프팅 내내 바벨이 정강이(Shins)에 닿아 있도록 유지합니다. 바닥을 밀어내며 올라오고, 상단에서 둔근을 짜주고 고관절을 완전히 확장하여 락아웃(Lock out)합니다.

장비: 바벨(Barbell) · 타겟: 둔근(Glutes) · 보조: 대퇴사두근(Quadriceps), 햄스트링(Hamstrings), 종아리(Calves), 코어(Core) · 미디어 ID: qXTaZnJ

흔히 "모든 운동의 왕"이라 불리는 바벨 풀 스쿼트(Barbell Full Squat)는 하체 전체와 코어의 조화로운 근력을 요구합니다. 파셜 스쿼트(Partial Squats)와 비교했을 때, 평행 지점 아래로 내려가는 것(Breaking parallel)은 둔근과 햄스트링의 활성화를 극대화합니다. 이는 거의 모든 근력 및 비대(Hypertrophy) 프로그램의 기초가 됩니다.

핵심 큐(Key cues): 바를 상부 승모근(High bar) 또는 후면 삼각근(Low bar)에 위치시킵니다. 하강 전 코어를 브레이싱하고, 무릎을 발가락 방향에 맞춰 바깥으로 밀어내며, 고관절을 뒤로 빼며 앉고, 허벅지가 바닥과 평행을 이룰 때까지 내려갑니다. 발 전체로 지면을 밀며 일어납니다.

장비: 덤벨(Dumbbell) · 타겟: 이두근(Biceps) · 보조: 전완근(Forearms) · 미디어 ID: NbVPDMW

덤벨 바이셉 컬(Dumbbell Biceps Curl)은 팔을 위한 가장 잘 알려진 고립 운동(Isolation exercise)입니다. 양쪽을 독립적으로 훈련하면 양팔 사이의 근력 불균형을 식별하고 교정하는 데 도움이 됩니다. 회외(Supinated, 손바닥이 위를 향하는) 그립은 동작의 상단에서 이두근의 수축을 극대화합니다.

핵심 큐(Key cues): 팔꿈치를 옆구리에 고정한 채 곧게 섭니다. 컬을 올릴 때 손목을 회외시키고, 상단에서 쥐어짜듯 수축하며, 반동을 주지 않고 통제하며 천천히 내립니다. 어깨나 하부 요추의 모멘텀(Momentum)을 사용하는 것을 피하십시오.

장비: 체중(Body Weight) · 타겟: 광배근(Lats) · 보조: 이두근(Biceps), 전완근(Forearms) · 미디어 ID: lBDjFxJ

턱걸이 (Pull-up)는 상체 당기기 근력 (Pulling strength)을 위한 맨몸 운동의 표준입니다. 이는 주로 광배근 (Latissimus dorsi)을 발달시켜 선망의 대상인 V-테이퍼 (V-taper)를 만들어내며, 이두근 (Biceps), 후면 삼각근 (Rear deltoids), 그리고 코어 안정화 근육 (Core stabilizers)을 강력하게 개입시킵니다. 초보자용 (밴드 보조)부터 상급자용 (중량 추가)까지 난이도 조절이 가능합니다.

핵심 큐 (Key cues): 오버핸드 그립 (Overhand grip)으로 어깨너비 또는 그보다 약간 넓게 잡고 데드 행 (Dead hang) 자세를 취합니다. 견갑골 (Shoulder blades)을 하강시켜 광배근 (Lats)의 움직임을 시작한 다음, 가슴을 바 (Bar) 쪽으로 당깁니다. 가동 범위 (Range of motion)를 유지하기 위해 반복 횟수 사이에는 완전히 내려옵니다.

장비: 덤벨 (Dumbbell) · 타겟: 삼각근 (Delts) · 보조: 승모근 (Traps) · 미디어 ID: DsgkuIt

덤벨 사이드 레터럴 레이즈 (Dumbbell Lateral Raise)는 어깨 너비를 키우기 위한 대표적인 고립 운동 (Isolation exercise)입니다. 넓은 어깨 모양을 결정짓는 삼각근 (Deltoid)의 측면 (Lateral/middle)두를 직접적으로 타겟팅합니다. 부하 (Load)보다는 통제된 템포 (Tempo)와 엄격한 자세 (Form)가 훨씬 더 중요합니다.

핵심 큐 (Key cues): 운동 내내 팔꿈치를 약간 굽힌 상태를 유지하며 섭니다. 덤벨을 양옆으로 들어 올려 팔이 바닥과 평행이 될 때까지만 올립니다. 그 이상 높이 올리지 마세요. 손목이 아닌 팔꿈치를 주도적으로 움직입니다. 긴장 시간 (Time under tension)을 극대화하기 위해 통제된 상태에서 천천히 내립니다.

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

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

const exercises = require("./data/exercises.json");
console.log(`Total exercises: ${exercises.length}`);
// Bodyweight exercises only
...

interface Exercise {
id: string;
name: string;
...

이 리포지토리 (Repository)는 개발자 설정 마법사 및 구조화된 운동 데이터셋 (Structured exercise dataset) — 운동 메타데이터 (Metadata) 및 다국어 지침 번역을 포함합니다. 운동 미디어 (Media)는 포함되어 있지 않습니다.

• 기본 운동 데이터는 ExerciseDB v1(데이터 소스 및 저작권 표기 참조)에서 가져왔습니다. 재사용하기 전에 ExerciseDB의 이용 약관을 검토하십시오. 운동 미디어(이미지 및 GIF)는 이 저장소에 포함되어 있지 않습니다 — 공지 사항을 확인하십시오.
• 이 저장소는 기반이 되는 운동 콘텐츠에 대한 소유권을 주장하지 않습니다.
• 귀하가 권리 보유자로서 콘텐츠의 삭제 또는 명확한 설명을 원하신다면, 이슈(Issue)를 생성하거나 유지 관리자(Maintainer)에게 연락해 주시기 바랍니다.