Skip to content

Repository files navigation

RepDB Exercise Dataset icon

💪 Free Exercise Dataset — JSON + Images (RepDB free tier)

A free, ready-to-use multilingual fitness exercise dataset — JSON + 512 px flat WebP illustrations, with target muscles, equipment, MET values, and full instructions in English, German & Spanish. Free for personal and commercial in-app use, with attribution.

DataLanguagesLicenseFull dataset

⬇️ Download the 250-exercise ZIP → · 🌐 Browse live → · ⬆️ Paid tiers →


What is this?

This is the free tier of RepDB, a curated commercial exercise dataset. It contains the free-tier snapshot (currently 250 of 518+ exercises, 2026-08): each exercise ships as JSON with flat-style 512 px WebP illustrations (start/peak poses, or a single pose for stretches), target muscles, equipment, goals, tags, MET values, and step-by-step instructions in English, German, and Spanish.

Unlike the usual scraped exercise JSONs, everything here is original, consistent, and usable in commercial apps for free — the only hard requirement is attribution. And unlike an API, it's just files: no key, no rate limit, no uptime to worry about.

Important

Attribution is required. Place a visible link — "Exercise data by RepDB (repdb.co)" — in your app's about/credits screen, your project's README, or your website footer. That's the price of the free tier.

Copy-paste Markdown, HTML, and app-credit versions are ready in ATTRIBUTION.md.

License (summary)

Full text: LICENSE-DATA.md. The seven terms in short:

  1. Free for personal and commercial use inside applications — apps, websites, research projects, at no cost.
  2. Attribution required — a visible "Exercise data by RepDB (repdb.co)" link.
  3. No redistribution as a dataset — don't republish, resell, or repackage it (or a derivative) as a dataset, dataset repo, or API. In-app use only.
  4. Image modifications — resize/crop/recolor for in-app use is fine; upscaled or background-removed derivatives still fall under the no-redistribution rule.
  5. No generative-AI derivation — the images may not be used as input, reference, or training/conditioning material for generative models (image-to-image restyling, style transfer, fine-tuning, etc.); outputs count as derived datasets.
  6. premium-samples/ is evaluation-only — the paid-tier samples in that folder may not be used in production or redistributed.
  7. No warranty; not medical advice.

This repository is RepDB's own canonical free-tier distribution — term 3 restricts third parties, not this publication (see the "About this repository" note in the license). The index.html viewer code is MIT.

Quickstart

constdata=awaitfetch("https://exercise-dataset.com/exercises.json").then(r=>r.json());console.log(data.count,"exercises");constex=data.exercises[0];console.log(ex.name_en,"·",ex.name_de,"·",ex.name_es);console.log(ex.images.flat.start);// "images/flat/<id>-start.webp"
importjson, urllib.requesturl="https://exercise-dataset.com/exercises.json"data=json.load(urllib.request.urlopen(url))
print(data["count"], "exercises")
forexindata["exercises"]:
print(ex["id"], "→", ex["body_part"], ex["equipment"])

Schema

exercises.json is a single object: { name, homepage, license, schema_version, count, note, exercises[] }.

Each entry in exercises[]:

FieldTypeNotes
idstringURL-safe slug, e.g. bulgarian-split-squat
name_en / name_de / name_esstringDisplay name per locale
description_en / _de / _esstringOne-line summary (where available)
instructions_en / _de / _esstring[]Step-by-step
tips_en / _de / _esstring[]Form cues (where available)
categorystringstrength, stretching, …
force_typestringpush / pull / static / dynamic
mechanicstringcompound / isolation
difficultystringbeginner / intermediate / advanced
equipmentstringe.g. dumbbell, kettlebell, cable — absent for bodyweight-only moves
body_partstringPrimary region
primary_muscles / secondary_musclesstring[]Anatomical slugs
goalsstring[]e.g. hypertrophy, strength
tagsstring[]e.g. knee_safe, no_axial_load
metnumberMetabolic equivalent (for calorie estimates)
is_unilateral / is_bodyweightbool
imagesobject{ flat: {start, peak} }or{ flat: {main} } → repo-relative WebP paths

Images

  • images/flat/ — flat-illustration style on a solid designed background, 512×512 WebP.
  • Most exercises have two poses, start and peak; stretches and holds have a single main pose. Handle both shapes.
  • Some near-identical exercise variants intentionally share the same image file (aliases) — key your UI by exercise id, not by image path.
  • The path is already in each record — ex.images.flat.peakimages/flat/<id>-peak.webp.

Multilingual

Names, descriptions, instructions, and tips ship in English, German, and Spanish for every exercise in this snapshot — same coverage as the paid dataset.

premium-samples/ — paid-tier preview (evaluation only)

The premium-samples/ folder holds a handful of Standard-tier assets — 5 looping, transparent-background exercise animations, the same clips shown on repdb.co — so you can judge the paid quality before buying. They are evaluation-only: not for production use, not for redistribution (license term 6). See them rendered on the live viewer.

Free vs. paid tiers

Free (this repo)StarterStandard
Imagesflat, 512 pxclassic white-background, 1024 px + flatStarter + transparent backgrounds + looping animations
Exercise setdated snapshotfull, growing datasetfull, growing dataset
Updatesquarterly lagged snapshotcontinuouscontinuous
FormatsJSON + WebPJSON + SQLite + WebPJSON + SQLite + WebP + animations
LanguagesEN · DE · ESEN · DE · ESEN · DE · ES
Licenseattribution, in-app onlycommercial, no attributioncommercial, no attribution

For perspective: our free tier ships the resolution ExerciseDB charges $299 for.

➡️ repdb.co/pricing — one payment, no subscription, no API, no rate limits.

See it in real apps

Example integrations (each vendors this dataset):

Links

About

Free exercise dataset in JSON — 250 exercises with 512px WebP images, muscles, equipment, MET, and EN/DE/ES instructions. Commercial in-app use with attribution.

Topics

Resources

Stars

10 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages