Connect with API key

Your key stays in your browser and is only sent to Hevy — . Generate it at hevy.com/settings?developer (Hevy Pro subscription required).

Hevy API key

Bodyweight (kg) optional Standards

Remember my key on this device

Tip: if the browser blocks the request (CORS), use CSV mode instead.

Import a CSV file

In the Hevy app: Profile → Settings → Export Data. Drop the workouts.csv file here. Everything is processed locally — .

Tip for non-English users: Hevy's exercise catalog is in English only. If your Hevy app is set to another language (e.g. French, Spanish), the export uses translated names and some exercises may fall back to a keyword-based match. For the most accurate results, switch Hevy to English before exporting (Profile → Settings → Language), then export the CSV.

Have a Hevy Pro account? The is even more precise — it uses Hevy's stable exercise IDs directly, so there's no title-matching ambiguity (near-zero margin of error), no matter the app's language.

Choose a CSV file or drag & drop

Bodyweight (kg) Standards

Loading…

Crunching your lifts — this can take a few seconds.

Rank by muscle group

How ranks are calculated

Every muscle group gets one of nine ranks, based on your real training — aggregated across your top compound lifts, not on a single lucky set. Here is the exact method.

The method

Each set you log is turned into a comparable strength score, then aggregated per muscle group.

Estimate a 1RM for every exercise. For each exercise, your best working set across all your sessions is converted to an estimated one-rep max using the Epley formula (reps are capped at 12 to stay realistic).
Resolve the real load. Bodyweight movements add your bodyweight (e.g. weighted dips), assisted machines subtract the assistance, and pure bodyweight reps (abs, push-ups, pull-ups) use an estimated fraction of your bodyweight so they still count.
Normalize to a reference lift. Each exercise has a coefficient relative to its group's reference lift (Squat for Legs, Bench for Chest, etc.). Machines and isolation lifts (calf press, back extension, pec deck…) get higher coefficients so their big loads don't inflate the rank.
Divide by bodyweight. Strength is measured relative to your bodyweight, pulled from Hevy's measurements (or entered manually). Female standards apply a ~0.72 scaling factor.
Aggregate the top 3 compound lifts. Per group, we take your top 3 compound lifts (those with at least 3 sessions logged) and average them with decreasing weights: 1.0 / 0.5 / 0.25. This spreads the score across your real training instead of hanging on a single lucky set.
Match to a rank. The composite ratio is compared to nine thresholds per muscle group (see the table below). Click any group on your results dashboard to see exactly which lifts were used and which were excluded.

estimated 1RM = weight × (1 + reps / 30)

Epley formula, then per exercise: ratio = 1RM ÷ coefficient ÷ bodyweight, and per group: composite = (r₁ × 1.0 + r₂ × 0.5 + r₃ × 0.25) ÷ 1.75.

Guardrails against gaming the score

Isolation exercises don't drive the rank when a compound exists in the same group. Calf press, back extension / hyperextension, pec deck, shrugs, most curls and triceps extensions are flagged as isolation. If no compound qualifies, the isolation lifts are used as a fallback and the rank is capped at Titan.
Minimum 3 sessions. A lift needs at least 3 distinct training days to count. Doing pec deck twice for a friend won't outrank your bench. If no lift in a group reaches 3 sessions, we still use what's there so you get feedback, but the rank is capped at Platinum.
Cardio and mobility are ignored. Only lifts with a real measurable load contribute to your rank.

Thresholds per muscle group

Minimum equivalent reference-lift 1RM ÷ bodyweight to reach each rank (male standards; multiply by ~0.72 for female). These are applied to the composite ratio, not to a single set.

Good to know

One rank per muscle group today (Legs, Chest, Back, Shoulders, Arms, Core). Per-individual-muscle ranks are planned.
Your data never leaves your device — the API key talks directly to Hevy, and CSV files are parsed locally in your browser. Nothing is sent to any server.
Ranks are estimates. Coefficients and thresholds are tunable and will keep improving. This project is not affiliated with Hevy.

How your data is handled

Short version: everything stays on your device. Hevy Ranks is a static web app — there is no backend, no database, no analytics, no tracking. Below is the exact breakdown of what happens to your data, per mode.

🖥️ Runs 100% in your browser 🚫 No server, no database 📊 No analytics, no cookies 🔓 Open source (verifiable)

CSV mode

The CSV file never leaves your device. It's read directly in your browser via the standard File API and parsed locally by src/csv.js. Nothing is uploaded anywhere.
The exercise catalog (used to identify each lift) is a single static JSON file shipped with the app — data/exercise-templates.json. It's loaded once from GitHub Pages, then everything runs locally.

API-key mode

Your API key is used only to talk to Hevy directly (https://api.hevyapp.com/…) from your browser. The request goes straight from you to Hevy — Hevy Ranks has no proxy, no server, no middleman that could see it.
The key is stored in your browser (in localStorage) only if you tick "Remember me". You can clear it at any time by unticking the box, clicking "Disconnect", or clearing your browser storage for this site.
Rate limits and errors come from Hevy's API directly. Hevy Ranks doesn't log them anywhere.

What's stored in your browser

localStorage: your API key (only if "Remember me" is on), your bodyweight, and your reported sex — so you don't have to re-enter them each time.
sessionStorage: a cached copy of your last results HTML, so refreshing the page or clicking "How it works" doesn't force a re-import. Cleared automatically when you close the tab.
No cookies. The site sets zero cookies.

Third parties

Hevy API (only in API-key mode) — receives your API requests when you fetch your workouts. Governed by Hevy's own privacy policy.
GitHub Pages — serves the static files (HTML, CSS, JS, rank images). Your browser fetches these when you load the site. GitHub may log basic request metadata (IP, user agent); see GitHub's privacy statement. Hevy Ranks itself doesn't collect or forward any of this.
Nothing else. No Google Analytics, no Cloudflare Insights, no Sentry, no CDN pixel, no ad network.

How to wipe everything

In the app Untick "Remember me" on the API panel and click "Disconnect" — clears the stored API key.
In your browser Open DevTools → Application → Storage → "Clear site data" (Chrome / Edge) — wipes everything: localStorage, sessionStorage and cache for this site.

Verify it yourself

Everything above is auditable — the whole project is open source at github.com/BenjiPy/hevy-ranks. The only outbound network calls you'll ever see are:

GET requests to the site itself (HTML/CSS/JS/images from GitHub Pages).
GET data/exercise-templates.json — the exercise catalog.
GET https://api.hevyapp.com/… — only when you use API-key mode.

Open your browser's Network tab and try it — no other requests are made. If you ever spot one that shouldn't be there, open an issue — that would be a bug.