Suggest workouts
suggest_workoutsRead-only
New workouts from our generator, as text. Ask this instead of writing workouts yourself. Nothing is saved.
Example, two people with an echo bike, rower and ski erg, 40-60 min:
suggest_workouts(count=5, people=2, minutes_min=40, minutes_max=60,
equipment=["echo-bike", "row-ergometer", "ski-erg"], bodyweight=False)
A shortfall says what blocked it.Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sex | No | Who trains, for the weights and machine doses: "men", "women", or "mixed" (a man and a woman together: each at their own; Hyrox stations at the mixed doubles race load). Omitted when the user did not say: every line reads both, men's/women's ("9/6 kg", "12/10 kcal"). Anything but men gets only workouts with a women's weight on every loaded line. Example: "women". | |
| only | No | True: the workouts hold the included movements and nothing else (each may repeat). Needs include. Example: true. | |
| count | No | How many workouts, at most 5; from 3 on, a mix of archetypes (at most 2 of one unless nothing else fits). Example: 3. | |
| people | No | How many train together with one of each machine. Above 1, only workouts they can share come back: partner workouts (taking turns on a station), or EMOMs/intervals with a different machine on every line and at least one line per person (start apart, rotate). Example: 2. | |
| exclude | No | Movement slugs or names (from find_movements) every workout must leave out. Example: ["burpees"]. | |
| include | No | Movement slugs or names (from find_movements) every workout must hold. Example: ["wallballs", "sled-push"]. | |
| partner | No | True: only partner workouts (two people share the work: turns at a station, or each on a station at once, then swap). False: none. Omitted: either. Example: true. | |
| archetype | No | A key or name from list_archetypes; any when omitted. Example: "A5" or "chipper". | |
| equipment | No | What the athletes have, as list_equipment keys or names ("echo-bike" or "echo", "row erg", "ski erg"), one item per entry. Say "1 dumbbell" or "1 kettlebell" when there is only one: movements needing a pair (farmers carry, dumbbell bench press) are left out. Other counts are ignored ("1 echo" is the echo bike): say how many train in people. Movements needing anything else (a bench press needs a bench) are left out; runs need "running" in the list. A name matching several keys or none is an error naming them. Example: ["1 dumbbell", "box", "ski-erg"]. Omitted is a full gym. | |
| bodyweight | No | False also leaves out movements needing no equipment (burpees, runs), so only the listed equipment is used. Example: false. | |
| cap_minutes | No | A time cap the workout must fit, in whole minutes. Example: 30. | |
| minutes_max | No | Longest estimated workout length, in minutes. Example: 60. | |
| minutes_min | No | Shortest estimated workout length, in minutes. Example: 40. | |
| show_scores | No | True adds a line of scores under each workout: feasibility (0-100, can it be done as written), difficulty (0-100, the chance of not finishing inside the cap), and against the workout it was made from: stimulus (0-1, CrossFit's stimulus kept, with the levers changed), work (x the seed's), mix shift (how far the work moved between movement patterns), design (0-1) and, for Hyrox workouts, race fidelity (0-1). Example: false. | |
| temperature | No | 0 to 1. 0: the same ask always brings the same workouts. Above 0: other ones each call, the higher the further from the library workouts they vary (0.3 close variations, 1 far ones). Example: 0.3. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |