Skip to content

Open-source gym & body-weight tracker, now in the App Store (iPhone + Apple Watch) and as an Android APK. Plan routines, log workouts, see which muscles are trained, import from Strong/Hevy/FitNotes. Self-host it or use it on the phone alone.

Docs: the Coach's admin settings are on the AI Coach card of Settings → Admin dashboard, as the app names it

Duarte Santoseab71b44ae7a
diff --git a/docs/AI_COACH.md b/docs/AI_COACH.md
index cd89cf09e..fed0ccbc3 100644
--- a/docs/AI_COACH.md
+++ b/docs/AI_COACH.md
@@ -48,10 +48,10 @@ own (see [On the phone](#on-the-phone)).
The card appears only when all of these hold:
- **The master switch is on.** That is **Set up the Coach** on the admin card
- (**Settings → Admin → AI Coach**), and afterwards the toggle at the top of the same card. A
- provider that is connected and passes **Test the Coach** is not enough on its own: with the
- switch off, the server tells every app there is no Coach, and the card reads *Off right
- now — nobody sees it anywhere in the app*.
+ (**Settings → Admin dashboard**, the **AI Coach** card), and afterwards the toggle at the top
+ of the same card. A provider that is connected and passes **Test the Coach** is not enough
+ on its own: with the switch off, the server tells every app there is no Coach, and the card
+ reads *Off right now — nobody sees it anywhere in the app*.
- **The provider is connected**, so the admin card reads **ready**: a credential saved, or for
a compatible endpoint without a key, an endpoint.
- **The person is signed in.** A guest in the browser has no Coach, because a job reads a
@@ -67,7 +67,7 @@ picks it up the next time it is opened or reloaded.
**1. Get a key** from the provider's own console. For a compatible endpoint, get the URL it
answers on instead, and a key only if it wants one.
-**2. Connect it.** In the app: **Settings → Admin → AI Coach**.
+**2. Connect it.** In the app: **Settings → Admin dashboard**, the **AI Coach** card.
- Toggle the card on.
- Pick the provider chip.
@@ -147,7 +147,7 @@ Complete its normal browser sign-in and copy the token it prints. openGym never
that flow — it only ever receives the finished token. (Claude also accepts an Anthropic API key
here, under the same chip; the setup token is the route for a Claude subscription.)
-**3. Connect it.** In the app: **Settings → Admin → AI Coach**.
+**3. Connect it.** In the app: **Settings → Admin dashboard**, the **AI Coach** card.
- Toggle the card on.
- Pick the **Claude (Anthropic)** provider chip.
@@ -177,10 +177,10 @@ validator rather than trimmed. The card is kept in the Coach's history like ever
### Comparing with others on the instance
-Off unless the admin turns it on (**Settings → Admin → AI Coach → Advanced → Let people compare
-with each other**), and then still off for each person until they opt in themselves (**Compare
-with others here → Include me** in the Coach chat). The trade is symmetric: a profile that does
-not share sees nothing.
+Off unless the admin turns it on (**Settings → Admin dashboard**, the **AI Coach** card →
+**Advanced → Let people compare with each other**), and then still off for each person until they
+opt in themselves (**Compare with others here → Include me** in the Coach chat). The trade is
+symmetric: a profile that does not share sees nothing.
What is shown is coarse on purpose — a median across everyone sharing for sessions per week and
for the best estimated 1RM per exercise, next to the person's own number, plus where they rank.
diff --git a/website/docs.html b/website/docs.html
index 76535e1dc..406b5ae13 100644
--- a/website/docs.html
+++ b/website/docs.html
@@ -649,8 +649,8 @@ ALLOW_GUEST=0 # remove "Continue without account"</code></pre>
</ol>
<h3 id="coach-providers">Providers</h3>
- <p>It is <b>off by default</b>. An admin turns it on in <b>Settings → Admin → AI Coach</b> and
- picks who answers:</p>
+ <p>It is <b>off by default</b>. An admin turns it on in <b>Settings → Admin dashboard</b>,
+ on the <b>AI Coach</b> card, and picks who answers:</p>
<table class="cfg">
<tr><td><b>Anthropic, OpenAI, Google&nbsp;Gemini</b></td><td>Paste an API key from the provider's console. Plain HTTPS from the api process — runs on the default image.</td></tr>
<tr><td><b>OpenAI-compatible endpoint</b></td><td>Any server that speaks the Chat Completions API: <b>Ollama</b>, <b>LM Studio</b>, <b>vLLM</b>, <b>OpenRouter</b>, a gateway of your own. A key only if the endpoint wants one. Also the default image.</td></tr>
@@ -671,7 +671,7 @@ ALLOW_GUEST=0 # remove "Continue without account"</code></pre>
- OLLAMA_NUM_PARALLEL=1
mem_limit: 4g</code></pre>
<pre><code>docker exec -it &lt;ollama container&gt; ollama pull qwen2.5:3b</code></pre>
- <p>Then in <b>Settings → Admin → AI Coach</b>: provider <b>OpenAI-compatible endpoint</b> →
+ <p>Then on the <b>AI Coach</b> card (<b>Settings → Admin dashboard</b>): provider <b>OpenAI-compatible endpoint</b> →
Base URL <code>http://ollama:11434</code> → <b>List models</b> → pick the model →
<b>Test the Coach</b>. That's the whole setup.</p>
<p><b>Any model you can pull, you can use.</b> <code>ollama pull</code> whatever you like and