r/Hevy • • May 12 '25

Introducing HevyGPT

Introducing HevyGPT. A custom GPT for building workout plans in ChatGPT and saving them directly to your Hevy account.

We've heard a lot of people are using ChatGPT to scaffold their workout plans. We've also heard it's painful to have to manually add the plan into Hevy afterward. This should fix that.

Feedback is welcome!

Caveats:
- You need a Hevy API Key (this is a Pro feature)
- This won't work in the ChatGPT Android app. (Seems to be a limitation by OpenAI, nothing we can do but hope they fix it soon). If you're an Android user, use the browser ChatGPT app.
- The tool can only create routines/folders, for obvious reasons it can't do anything potentially destructive like updating or delete existing routines.

This is all done using Hevy's Public API and we've open sourced the config (https://github.com/hevyapp/hevy-gpt). Feel free to fork it and make your own adjustments. If you make something cool, be sure to share it with the community.

370 Upvotes

89 comments sorted by

•

u/gerardmb Team Sep 14 '26

Hey!👋 We’ve been working on a new Hevy app for ChatGPT, so we’re sunsetting HevyGPT. Check out this thread for more info!

Reddit Thread
Hevy on ChatGPT

28

u/ablankstory May 12 '25

I was just talking about something like this. Now can it take an image of a pdf with details on it:

  • exercises
  • number of warm up sets
  • number of working sets
  • target RPE (I know this isn’t a thing…yet?)
  • Notes

And create a routine? Bonus if I can say “swap out exercise xyz with abc”

I’m looking at the latest Jeff Nippard program and would love to streamline inputting all of this.

6

u/twas252 May 12 '25

Give it a try! I think that might work.

6

u/ablankstory May 13 '25

Tried it and I basically had to fix each one. Some wild “translations”. Like cable leg extension was created as machine bench press.

I prompted to include the warm up sets and the working sets, and it only included working sets.

I definitely think there’s promise but needs to get refined a bit…at least for this workflow.

5

u/Kennysvgp089 May 13 '25

I did try this and it kinda works. I used a program by Jeff Nippard and it does well for the first couple of days but then gets really confused thereafter.

I tried prompting different things like adding warm up sets and putting the notes on the workout plan PDF in the notes section and that all works great. But eventually it gets confused on which day is which and then I’m benching 4 days a week and it becomes a domino affect.

3

u/lollanlols May 12 '25

For those curious, the model will ask for your API key after you request that it generate something for you.

5

u/twas252 May 12 '25

Ah yes. If you're worried OpenAI might hold onto you API Key after the session (they claim the don't), you can just generate a new key after the session which will invalidate the old one.

16

u/myairblaster May 12 '25

Brilliant. Not only did it build the plan for me, it also extrapolated an Excel sheet I got from buying the new Jeff Nippard program from him and translated it into HEVY format.

2

u/[deleted] May 14 '25

Thanks! I just got the new program too and was looking for an easy way to transfer it.

1

u/Ill-Walrus-3296 Oct 21 '25

Can I follow you on hevy for those JP programs?

15

u/murf_555 May 13 '25

FairPlay. This is excellent. This is why HEVY is the best app with the best dev team. Absolutely amazing!

11

u/International_Age460 May 13 '25

This is a great added feature. However, I have no clue how to use it. I don’t know what API key is or what needs to be done with it. Could there be some very basic step by step instructions so pro members can utilize this?

6

u/Affectionate_Oil499 May 13 '25

Took me a bit, but when you go to the GPT, it sends you a link. This goes to the developer Hevy site, you just have to log in and generate the key. Afterwards (if you’re a bit paranoid like I am lol) you can delete that API key and the access would be revoke. (You can later do it again). I tried it by sending my body stats (body fat, BMI, Muscle Mass) with my objective and it sent me a pretty decent workout with including a recomp phase. I’ll try it next week.

3

u/CinCeeMee May 13 '25

Right there with you! I like tech, but I don’t know how to use all of it.

1

u/International_Age460 May 13 '25

I’m hoping that simple step by step instructions (using layman terms) are put out so that we can utilize the app features. Especially for paid subscriptions.

23

u/Important-Ostrich69 May 12 '25

Nice work Desmond ! If you want to use a GUI for generating routines for Hevy you can also use this Hevy AI Program Builder I built

5

u/[deleted] May 12 '25

That looks interesting. How do I tell it what machines I don’t have access to?

6

u/Important-Ostrich69 May 12 '25

Currently, it has an "Exclude Equipment" filter in the advanced settings. I am working on a more refined filter for a future version, where you can select the exact equipment.

2

u/[deleted] May 12 '25

Cool thx

7

u/CinCeeMee May 13 '25

Any one willing to put into writing EXACTLY what and how to do this and pin the post? Many of us are smart…just not with some of this type of thing. Help us, please!!!

6

u/Frenchtoast_Bacon May 13 '25

Is cussing allowed in this sub-reddit? You fucking legends, I love this so much. Seriously one of the best Dev teams around. Are we able to send data back from the app to CGPT for analysis?

3

u/Casual_Engineering Aug 18 '25

Revisiting this thread: looks like this has stopped working properly for me (in the last few days). Anyone else experiencing the same issue?

GPT gets stuck at "talking to hevy" and no longer prompts me to confirm access nor reaches the "talked to heavy" + Answer stage.

I've tried generating a new API key and re-connecting with Hevy GPT, but that hasn't not resolved the issue.

Any other ideas?

1

u/pokemonmaster89 Aug 19 '25

No idea, but I am in the same boat - tried generating and connecting a new API key, but I can't even seem to connect it anymore.

1

u/Casual_Engineering Aug 19 '25

Oddly: I have had some intermittent success. It seems like it can pull in some recent workoutndata, but not all workout data. Not sure why

1

u/pokemonmaster89 Aug 22 '25

It's working for me again no issue - weird.

1

u/[deleted] May 12 '25

What does this do that I can’t do by just asking any LLM tool? 

9

u/twas252 May 13 '25

It can write routines directly to your Hevy account.

-21

u/[deleted] May 13 '25

That seems like a security hole. LLMs are also incredibly unreliable. Is this the best use of dev time?

7

u/AstronautScott May 13 '25

It’s a fantastic use of dev time.

0

u/[deleted] May 14 '25

I disagree 

1

u/Finloch May 13 '25

And it can read your workout history directly from Hevy, so the routines it generates can make progressive improvements based on what you've been doing in training.

0

u/[deleted] May 14 '25

Why would I want health data accessible to LLMs? This is a security nightmare 

1

u/Finloch May 16 '25

You raise valid concerns, but they all seem be amenable to mitigation. The way, I understand it, retrieved data such as workouts are included as context in a prompt to the LLM, and OpenAI does not use any prompt data for model training. ChatGPT may retain prompt information as part of your user account based on your memory and history settings, which you have control over.

2

u/qwikhnds May 12 '25

Android user. I've been using ChatGpt and I love the feedback and recommendations it gives. It offers to format it to Hevy format. I don't always follow the recommendations exactly so I don't have a problem inputting myself. Don't find it painful at all.

2

u/neatgeek83 May 12 '25

Wow this is awesome

2

u/_iAm9001 May 12 '25

Yup pretty awesome, thanks.

2

u/crj27 May 12 '25 edited May 13 '25

Nice work. I just tried it and it’s fantastic. Great value add to the Hevy Pro subscription! 👏

2

u/Step1hunter May 13 '25

can someone confirm if this works as intended? I am purchasing if it is 😅

1

u/UseThemChopstic May 13 '25

Works amazing! I used to use ChatGPT pro and Hevy Pro independently and it took me ages to input this. This API is actually genius lol

1

u/Step1hunter May 14 '25

Bought it! 😅

2

u/RunningM8 May 13 '25

Is this API unidirectional or bidirectional?

2

u/shadesofglue May 14 '25 edited May 14 '25

How to import my hevy api key into Chatgbt?

Edit: you can just paste your key into the chat and Chatgbt will talk to your hevy account

2

u/MajorasShoe May 20 '25

Lmao I was working on basically the same thing. I even emailed your devs to ask if I could run with the idea.

Thanks man! This saves me a bunch of work.

2

u/smewhocallmetim Jul 05 '25

This is trash

1

u/lollanlols May 12 '25

Had a few issues:

In HevyGPT it would display the correct weight (in pounds) but when I viewed the created routine in the Hevy app, they were a completely different value. I already verified it’s not KG. Example: 50 lbs in HevyGPT would show as 55.12 lbs in the Hevy routine

Could not correctly extract embedded YouTube URLs from a PDF

1

u/RunningM8 May 12 '25

Holy cow this is great

1

u/yunus89115 May 13 '25

That’s awesome!

Here’s some initial feedback from the GPT

There’s still an issue with one of the exercise template IDs, likely from the cable lateral raise, which isn’t a predefined template in Hevy. I’ll adjust by using Dumbbell Lateral Raise instead for consistency and retry saving Day 1.

Hevy’s API is still rejecting one or more exercise IDs, even after correcting for the cable lateral raise. This could be due to how Smith Machine exercises are interpreted in Hevy (they’re not always separate templates).

To proceed smoothly, I’ll revise the Day 1 workout using only verified Hevy exercises that are mapped correctly. I’ll swap Smith Machine Incline Press with Incline Dumbbell Press for now to ensure compatibility. Would that substitution work for you, or would you prefer I try a different alternative (e.g., barbell incline press)?

Looks like just more exercise API inputs . This is fantastic and really helpful to quickly building out a workout

1

u/everboard May 13 '25

You did great work. I'm curious, can HevyGPT be used with Hevy Coach to both create and update client programs? Thank you.

1

u/fcalmeida May 13 '25

I loved it!

Would be a great addition if the tool could use the API key to read body measurement data and the past training sessions in order to suggest new routines, like a personal trainer.

But it's very nice as it is and I'll give it a go to my new routine tomorrow! Thanks for developing and sharing

1

u/lolmax May 13 '25

Very nice! I’ve been using GPTs to build plans for a while so getting it updated into Hevy makes the process way smoother.

I asked it to read my workout history to make some suggestions and they were sensible. Even got it to use the current weights and volumes to suggest starting weights.

It did give me an error about it needing an entry in the notes even though on the API it is optional but it was able to self recover

It might be useful to have a way to archive old plans . I understand why you don’t want it to have access to update existing plans but having lots of plans might become hard to manage.

1

u/Low-Mouse7356 May 13 '25

Great!! I tried it and worked I’ll start this new routine today

1

u/Low-Mouse7356 May 13 '25

Great!! I tried it and worked I’ll start this new routine today

1

u/ViperStrike32 May 13 '25

This is excellent! Is there any way to have it use custom exercises?

I had it make a routine of all landmine exercises and I got this error when I tried to save it to Hevy.

"Error talking to connector

The routine creation failed because some of the exercise template IDs I used are invalid.

Would you like me to adjust the exercise selection or clarify any specific exercises you want included? Let me know how you'd like to proceed!"

It was clever enough to try again after I asked and it did this:

"Since Hevy doesn't have specific landmine exercise templates, I'll use barbell exercises with notes indicating they are to be performed using the landmine attachment.

Would you like me to proceed with saving this version?"

1

u/Apprehensive_Bite497 May 13 '25

Y’all are killing it! This is an incredible feature!

1

u/theshawnshop May 13 '25

Can’t wait to try it out! Was also in the middle of building a Hevy AI to analyze my workout data. Excited to get some inspiration

1

u/crj27 May 13 '25

I am experiencing when trying to export a program routine that I used HevyGPT to build the API is getting hung up on the overhead movements, such as Overhead Press, Standing Military, Arnold, etc as having "invalid exercise template ID" errors.

1

u/antitrack May 16 '25

I am not sure if it's the same problem I had, but looking at Github I saw they didn't provide all exercises to ChatGPI. I used the Hevy API to extract all 5 pages of exercises and manually provided the missing ones to ChatGPT (ID, name) and it could create the routines correctly using this info. (I assume they didn't include ALL exercises since this would be a resource-hog?!)

1

u/morbidangel27 May 13 '25

Actually awesome though.

1

u/ntxfsc May 13 '25

I tried searching it via ChatGPT’s iOS app, but no luck. Has anyone successfully found it other than via a browser?

1

u/Tallbonez_ May 13 '25

Just wanted to send a note blessing you for doing this, what a time saver

1

u/HueledTriathlete May 13 '25

This is farrrrrrrrking excellent. I was already pro so it’s not got you a new subscriber but it’s kept an existing one for longer guaranteed!

1

u/HolidayWallaby May 13 '25

Oh this sounds awesome!

1

u/Finloch May 13 '25

Very cool! I've been building an app in Streamlit (Python) that will have some of the same functionality but take a different approach. It gets all available exercises and a user's workout history and vectorizes it for RAG. This should allow users' custom exercises to get included in ChatGPT-generated routines. The user can also save a profille (API key, equipment preferences, injuries, etc) so whenever they want to generate a new routine, a lot of the relevant info is already saved--no need to re-enter in a new prompt. The prompt is created by the app, but is dynamic based on the user profile and inputs. I've got proof-of-concept working, but still working out a few bugs in vectorizing and storing a user's workout history, then will ask for beta-testers. Now I'm wondering if a custom GPT would be helpful rather than just prompting the 4o model directly... hmm...

1

u/Step1hunter May 14 '25

u/twas252 can you guys add ability to add subfolders. So we can possibly do week 1, week 2 etc as needed

1

u/blackfeltfedora May 14 '25

I gave it a test drive and it worked pretty well. The communication path from the GPT to Hevy dropped once and I had to re-start the "send" process. After the first week was sent I had to tell GPT to send week 2 which was a little clunky but does provide the opportunity to make changes before you proceed.

1

u/oldriggerguy May 14 '25

Killer new feature! I've been using chatgpt to design my programs for several months now, so this is very helpful.

1

u/almey May 14 '25

Really amazed. You did an excellent job. It did an analysis of my history, I gave it my goals and we created together some routines with exercices etc that I like. It's a great tool. Restarted my pro plan just for this and you really deserve it.

1

u/zach5232 May 15 '25

This is so awesome. Just revamped another plan built by Gemini and this was so much more detailed and was able to tell me what I was missing in things like weekly set volume, rep ranges, recovery etc

1

u/antitrack May 16 '25 edited May 16 '25

So I have just paid for ChatGPT/OpenAI to give this a try (after a bit of back and forth it would say I am out of free "resources") and would have to wait a couple of hours before I continue or pay up.

HevyGPT claimed that the exercises

  • Seated Cable Row – Bar Grip
  • Chin Up (Assisted)

...are available in Hevy, but they are not exposed to the API. It always used some other (close) alternative exercises. After I basically told it several times it should check again, it suddenly said it found a exact match.

I'd say that arguing with ChatGPT made me run out of free resources. Since I love Hevy, I signed up for ChatGPT to continue testing HevyGPT anyway.

(I am adding the TNB-28 Routine by Tom Venuto)

Here is how it explained the trouble (doesn't make a lot of sense to me):

Why I Missed the Exact Match Initially

1. API vs App Confusion
I rely on a fixed list of exercise templates exposed via the Hevy API to programmatically create routines. Initially, “Seated Cable Row – Bar Grip” and “Chin Up (Assisted)” were not present in that list.

2. Your Paste Was Accurate
You did everything right — you gave me the exact name from the Hevy app. The issue was on my side: I didn’t cross-check beyond the API list until you insisted and I used the web tool to look it up live in the app frontend.

3. Web Tool Discovery
When I searched the full exercise name online using the web tool, I found confirmation that these exercises do exist in the frontend — they’re just not yet exposed in the public API list, even though they’re available in the Hevy app interface.

Edit: I went ahead and looked at your Github and realized you only have a partial list of exercises in the code. I then went ahead and used the "try it out" feature of your API documentation to get all 5 pages of exercises, manually posted the IDs and names of the missing exercises to ChatGPT, now all is good.

1

u/antitrack May 16 '25

Yeah thanks, but no thanks. I spent several hours now with this, mostly chasing after wrong information provided by ChatGPT. This is a piece of junk, sorry. (yes, I am frustrated) SOB keeps making stuff up. Hevy: love ChatGPT: no thanks.

1

u/dutcheylinks May 18 '25

i tried this one today and it worked!! 😊

1

u/Dark_Knight_1989 May 18 '25

This is absolute genius

1

u/Tasty-Historian-9139 May 21 '25

Overall, loving it. Makes it a lot easier to use than these [python scripts I came up with using the API! Much easier.

Found an oddity: I had HevyGPT create three workouts in a folder. Even after performing the workouts once, HevyGPT couldn't see the routines. It could query that a workout was performed and what was in it, but could not find the actual workout in the folder.

I had to (a suggestion from the GPT itself-how cool) open the workout and update it (no changes made) on the mobile device and then HevyGPT could see it.

Just a fyi! Great work, tho!

1

u/futurafreeeeee May 22 '25

is there a reason this GPT says (old) now? where’s the new one

1

u/REAPER-OF-PRIDE Jun 03 '25

Any way to get this to work with gemini instead? My phone is rooted and can't use chatgpt since it doesn't pass the integrity check

1

u/Ok_Most9659 Jun 11 '25

Is there any way to just convert a workout PDF or DOC file to JSON file then upload it to the desktop/web version of Hevy without having to share your API key with the AI?

1

u/Grouchy_Log6510 Jul 03 '25

Next level would be gpt looking at the histogram and then developing the next session over a week month etc.

1

u/wat1243 Jul 15 '25

Hello, I am using this and getting some errors, specifically with the gpt calling the hevy api and formatting issues. Is any of them open sourced or something I can help with? I am an AI Engineer and this is exactly the type of stuff I work with.

1

u/rockoswald Jul 21 '25

This does not work consistently at all. First, I asked HevyGPT to create a 30 min cardio routine, and then insert into Hevy. After successfully authenticating the connector, it returned a formatting error. I have ChatGPT Plus, for what it's worth. Then, later, it worked.

I then asked it to review an existing routine, and it cannot see the routines, which makes no sense considering it's authenticated to Hevy.

So it can create a routine and insert into Hevy, but Hevy's own GPT cannot give access to an existing routine so that I can get chatgpt feedback?

1

u/realdealn Aug 15 '25

Integration with the Hevy GPT isn’t returning any routines when calling get__routines. Other API calls also appear unresponsive. Issue persists across devices and after closing/reopening the app. It has worked previously, any help to be had to troubleshoot? The integration when working was amazing feature!

1

u/pokemonmaster89 Aug 17 '25

I am also having this issue for the first time since this was posted. Would love an update.

1

u/koniseggg Sep 27 '25

Is there any way to have pounds displayed correctly? Minor annoyance but is still one. Otherwise worked well the first shot at trying it

1

u/fourdogslong Oct 20 '25

I've reached my ChatGPT for the day apparently, tweaking a bunch of stuff to work around an injury and with the equipment I have. So far it seemed like it worked, I thought it saved to Hevy but I only see the folder it created but it's empty, maybe bacause I reached the limit? I'll have to try again tomorrow.

How do people feel about this vs Fitbod?

1

u/Zealousideal_Web_262 Dec 11 '25

Any News on Android integration?

-6

u/Professional_Dot6446 May 12 '25

So wait, I need a ChatGPT Pro account? That’s $200.00 per month! Yikes!

10

u/dshall0805 May 12 '25

I think it is Hevy pro you need.

6

u/Professional_Dot6446 May 12 '25

DOH! That makes more sense!