Skip to content
Back to search

openathlete

The open-source alternative to TrainingPeaks. Self-hostable endurance training platform. Your data stays yours.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/openathleteorg/openathlete with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/openathleteorg/openathlete'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/openathleteorg--openathlete/badge.svg)](/listings/openathleteorg--openathlete)

HTML

<a href="/listings/openathleteorg--openathlete"><img src="/api/listings/openathleteorg--openathlete/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

To get a local copy up and running, please follow these simple steps.

Prerequisites

Here is what you need to be able to run OpenAthlete.

- **Node.js** (Version: >=22.14.0) - We recommend using [nvm](https://github.com/nvm-sh/nvm) for version management - **pnpm** (Version: >=9.x) - Fast, disk space efficient package manager - **PostgreSQL** (Version: >=13.x) - Database - **Git** - Version control

> If you want to enable AI features, you may need to obtain API credentials. More details can be found in the [documentation](https://docs.openathlete.org).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 361 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <a href="https://openathlete.org">
  3. <img src="doc/imgs/readme-hero.webp" alt="OpenAthlete: serious endurance training, without the subscription">
  4. </a>
  5. </p>
  6. <h3 align="center">Serious endurance training. Without the subscription.</h3>
  7. <p align="center">
  8. The open-source training platform for runners, trail runners, triathletes, cyclists and their coaches.
  9. <br />
  10. Plan your season, send structured workouts to your watch, see what every session did to your fitness.
  11. <br />
  12. <br />
  13. <a href="https://app.openathlete.org/auth/create-account"><strong>Create a free account »</strong></a>
  14. <br />
  15. <br />
  16. <a href="https://openathlete.org">Website</a>
  17. ·
  18. <a href="https://docs.openathlete.org">Documentation</a>
  19. ·
  20. <a href="https://docs.openathlete.org/docs/getting-started/self-hosting">Self-hosting</a>
  21. ·
  22. <a href="https://discord.gg/j4PP6tDwuP">Discord</a>
  23. ·
  24. <a href="https://api.openathlete.org/docs">API</a>
  25. </p>
  26. <p align="center">
  27. <a href="https://github.com/openathleteorg/openathlete/stargazers"><img src="https://img.shields.io/github/stars/openathleteorg/openathlete" alt="GitHub stars"></a>
  28. <a href="https://github.com/openathleteorg/openathlete/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-AGPLv3-purple" alt="License"></a>
  29. <a href="https://github.com/openathleteorg/openathlete/releases"><img src="https://img.shields.io/github/v/release/openathleteorg/openathlete" alt="Latest release"></a>
  30. <a href="https://github.com/openathleteorg/openathlete/pulse"><img src="https://img.shields.io/github/commit-activity/m/openathleteorg/openathlete" alt="Commits per month"></a>
  31. <a href="https://apps.apple.com/app/id6756783342"><img src="https://img.shields.io/badge/App_Store-iPhone-0D96F6?logo=apple&logoColor=white" alt="Download on the App Store"></a>
  32. <a href="https://play.google.com/store/apps/details?id=org.openathlete"><img src="https://img.shields.io/badge/Google_Play-Android-34A853?logo=googleplay&logoColor=white" alt="Get it on Google Play"></a>
  33. <a href="https://discord.gg/j4PP6tDwuP"><img src="https://img.shields.io/badge/Discord-Community-5865F2" alt="Discord"></a>
  34. <a href="https://buymeacoffee.com/openathlete"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Support-FFDD00?logo=buymeacoffee&logoColor=black" alt="Buy Me a Coffee"></a>
  35. </p>
  36. ## Why OpenAthlete
  37. Training platforms keep years of your data, charge coaches per athlete, and can be bought or shut down. Today's Plan closed in 2024; TrainingPeaks has belonged to Garmin since July 2026.
  38. OpenAthlete is free on our servers in France and free on yours. The code is public under AGPL-3.0, the training-load formulas are in this repository, and you can export everything at any time. It is built by an independent developer and ultra runner in Grenoble, with no investors.
  39. ## What it does
  40. <img src="doc/imgs/readme-plan.webp" alt="Training calendar on desktop and phone">
  41. **Plan.** A calendar that thinks in seasons, weeks and sessions: training blocks, A/B/C races, illness and travel periods that move the sessions they cover, whole weeks copied or shifted with undo, and a calendar feed for Google, Apple or Outlook.
  42. **Build and sync.** Structured workouts with targets from your own zones (pace, power, heart rate, % of VMA or FTP), a reusable library, and delivery to **Garmin, COROS and Suunto** watches at the next sync.
  43. <img src="doc/imgs/readme-analyse.webp" alt="Activity analysis with the AI read of the session">
  44. **Analyse.** Activities from **Garmin, COROS, Suunto, Polar and Strava**, or FIT, GPX and TCX files. Each interval graded against the plan, detected climbs, time in zones, aerobic decoupling, pace adjusted for gradient and weather, and non-destructive fixes for heart-rate spikes.
  45. <img src="doc/imgs/readme-progress.webp" alt="Records and recovery metrics">
  46. **Progress.** Records by distance and duration, year against year; critical speed and power; fitness, fatigue and form (CTL, ATL, TSB) from heart rate or perceived effort, projected over your planned sessions; HRV, resting heart rate and sleep from your watch. Every metric says what it measures and where it stops being reliable.
  47. <img src="doc/imgs/readme-coach.webp" alt="Coach dashboard and coach–athlete messages">
  48. **Coach.** Compliance, volume and form for every athlete on one screen, alerts for reported pain, inactivity and unread messages, planning for several athletes at once, comments and real-time chat. Five athletes free, unlimited with Supporter.
  49. **AI, on your terms.** Generate or edit a session from a sentence, get a short read of each activity and three questions on how it felt. Bring your own key (OpenAI, Anthropic, Google, Mistral, OpenRouter, DeepSeek, xAI, Groq, or a local model when self-hosted), pick the model per feature, or use the allowance included with Supporter. Nothing reaches an AI provider until you allow it. An **MCP server** lets Claude, ChatGPT or Cursor read your training and plan sessions straight into your calendar.
  50. **Mobile.** Native apps on the [App Store](https://apps.apple.com/app/id6756783342) for iPhone and on [Google Play](https://play.google.com/store/apps/details?id=org.openathlete) for Android, with notifications and session reminders. The web app is built for phones too and installs on the home screen.
  51. ## How it compares
  52. | | OpenAthlete | TrainingPeaks | intervals.icu | Strava |
  53. | --- | --- | --- | --- | --- |
  54. | Open source, self-hostable | ✅ AGPL-3.0 | ❌ | ❌ | ❌ |
  55. | Planned workouts sent to the watch | ✅ Free (Garmin, COROS, Suunto) | Premium only | ✅ | ❌ |
  56. | Fitness / fatigue / form | ✅ Formulas in the code | ✅ | ✅ | Subscription |
  57. | AI | Your key, or included with Supporter; MCP server | — | Connector (Supporter) | — |
  58. | Coaching | 5 athletes free, unlimited from €50/yr | From $21.99/mo + per-athlete fees | Supporter | — |
  59. | Athlete price | Free (Supporter from €5/mo or €50/yr, optional) | $19.95/mo or $134.99/yr | Free ($4/mo Supporter) | €59.99/yr |
  60. Prices from each vendor's pricing page, checked on 3 November 2026 (USD before tax). Detailed, sourced comparisons: [openathlete.org/compare](https://openathlete.org/compare).
  61. ## Built with
  62. React 19 and Vite (web, with Capacitor for iOS and Android), NestJS 11 with BullMQ jobs and Mastra agents (API), Prisma and PostgreSQL with pgvector, Redis, Next.js (website), Paraglide (6 languages), Tailwind CSS.
  63. <!-- GETTING STARTED -->
  64. ## Getting Started
  65. To get a local copy up and running, please follow these simple steps.
  66. ### Prerequisites
  67. Here is what you need to be able to run OpenAthlete.
  68. - **Node.js** (Version: >=22.14.0) - We recommend using [nvm](https://github.com/nvm-sh/nvm) for version management
  69. - **pnpm** (Version: >=9.x) - Fast, disk space efficient package manager
  70. - **PostgreSQL** (Version: >=13.x) - Database
  71. - **Git** - Version control
  72. > If you want to enable AI features, you may need to obtain API credentials. More details can be found in the [documentation](https://docs.openathlete.org).
  73. ## Development
  74. ### Setup
  75. ```sh
  76. git clone https://github.com/openathleteorg/openathlete.git
  77. cd openathlete
  78. nvm use && pnpm install
  79. # PostgreSQL (with pgvector) and Redis
  80. docker compose -f docker-compose.dev.yml up -d
  81. # Environment files, then edit them if needed
  82. for f in apps/api apps/web libs/database; do cp $f/.env.example $f/.env; done
  83. # Prisma client, shared package, database
  84. pnpm database run db:generate && pnpm shared build && pnpm database run db:deploy
  85. pnpm dev # API on http://localhost:3000, web app on http://localhost:5173
  86. ```
  87. Run the same checks as CI with `scripts/verify.sh` (add `--integration`, `--build` or `--e2e` for the slower suites).
  88. ### Development Tips
  89. 1. Run type checking before committing:
  90. ```sh
  91. pnpm tsc:check
  92. ```
  93. 2. Format and lint your code:
  94. ```sh
  95. pnpm format:write
  96. pnpm lint:fix
  97. ```
  98. ### Upgrading from earlier versions
  99. 1. Pull the current version:
  100. ```sh
  101. git pull
  102. ```
  103. 2. Check if dependencies got added/updated/removed
  104. ```sh
  105. pnpm install
  106. ```
  107. 3. Apply database migrations by running <b>one of</b> the following commands:
  108. In a development environment, run:
  109. ```sh
  110. pnpm database run db:migrate dev
  111. ```
  112. In a production environment, run:
  113. ```sh
  114. pnpm database run db:deploy
  115. ```
  116. 4. Check for `.env` variables changes
  117. Compare your `.env` files with the `.env.example` files to see if new variables were added.
  118. 5. Start the server. In a development environment, just do:
  119. ```sh
  120. pnpm dev
  121. ```
  122. For a production build, run for example:
  123. ```sh
  124. pnpm build
  125. pnpm start
  126. ```
  127. 6. Enjoy the new version.
  128. <!-- DEPLOYMENT -->
  129. ## Deployment
  130. ### Self-hosting with Docker
  131. On any server with Docker and its Compose plugin:
  132. ```bash
  133. curl -fsSL https://raw.githubusercontent.com/openathleteorg/openathlete/main/scripts/install.sh | sh
  134. ```
  135. OpenAthlete then runs on `http://localhost` from the published images, with new random secrets in `openathlete/.env`. Add `-s -- --domain openathlete.example.org` to serve your domain over HTTPS with automatic certificates. Run the script again to update.
  136. The [self-hosting guide](https://docs.openathlete.org/docs/getting-started/self-hosting) covers HTTPS, device sync, AI, backups and upgrades from older setups.
  137. ### Manual Deployment
  138. For detailed deployment instructions, see our [self-hosting documentation](https://docs.openathlete.org/docs/getting-started/self-hosting).
  139. #### Backend (NestJS)
  140. 1. Build the application:
  141. ```bash
  142. cd apps/api
  143. pnpm install
  144. pnpm build
  145. ```
  146. 2. Set up environment variables in `.env`
  147. 3. Run database migrations:
  148. ```bash
  149. pnpm database run db:deploy
  150. ```
  151. 4. Start the server:
  152. ```bash
  153. pnpm start:prod
  154. ```
  155. #### Frontend (React + Vite)
  156. 1. Build the application:
  157. ```bash
  158. cd apps/web
  159. pnpm install
  160. pnpm build
  161. ```
  162. 2. Serve the built files using a web server (nginx, Apache, etc.)
  163. Example nginx configuration:
  164. ```nginx
  165. server {
  166. listen 80;
  167. server_name your-domain.com;
  168. root /path/to/apps/web/dist;
  169. index index.html;
  170. location / {
  171. try_files $uri $uri/ /index.html;
  172. }
  173. }
  174. ```
  175. ### Environment Variables
  176. #### Backend Required Variables
  177. ```properties
  178. DATABASE_URL="postgresql://user:password@host:5432/openathlete"
  179. REDIS_URL="redis://host:6379"
  180. JWT_SECRET_KEY="generate with: openssl rand -base64 32"
  181. HASH_PEPPER="generate with: openssl rand -base64 32"
  182. NODE_ENV="production"
  183. ```
  184. #### Frontend Required Variables
  185. ```properties
  186. VITE_API_BASE_URL="https://api.your-domain.com"
  187. ```
  188. For a complete list of environment variables, see the `.env.example` files in each app directory.
  189. ## Support OpenAthlete
  190. > OpenAthlete is built by one developer in Grenoble, supported by the community. There are three ways to help the project thrive:
  191. >
  192. > - **Become a Supporter** on [openathlete.org](https://openathlete.org/pricing): from €5/month or €50/year. It pays for the servers and adds AI on our keys and unlimited coached athletes.
  193. > - **Buy a coffee**: one-off support, even if you self-host. [buymeacoffee.com/openathlete](https://buymeacoffee.com/openathlete).
  194. > - **Contribute**: star the repo, open issues, send pull requests, translate, or join the [Discord](https://discord.gg/j4PP6tDwuP).
  195. >
  196. > Self-hosting is fully supported and always free, with no limits. Supporters fund the project's long-term sustainability.
  197. <!-- ROADMAP -->
  198. ## Roadmap
  199. OpenAthlete is actively developed. Here's what's coming next:
  200. - 🧩 **Modular Training Logic** - Custom goals, coach import, and flexible training methodologies
  201. - 📈 **Enhanced Dashboards** - Intuitive data visualizations and performance analytics
  202. - 🔗 **More Integrations** - Wahoo, Zwift, Oura, and more
  203. - 👥 **Clubs** - Club accounts with several coaches and groups
  204. See our [GitHub Issues](https://github.com/openathleteorg/openathlete/issues) for a detailed list of proposed features and known issues.
  205. <!-- LICENSE -->
  206. ## License
  207. Distributed under the [AGPLv3 License](https://github.com/openathleteorg/openathlete/blob/main/LICENSE). See `LICENSE` for more information.
  208. <!-- CONTRIBUTING -->
  209. ## Contributing
  210. Please see our [contributing guide](/CONTRIBUTING.md).
  211. ### Good First Issues
  212. We have a list of [good first issues](https://github.com/openathleteorg/openathlete/issues?q=is:issue+is:open+label:%22good+first+issue%22) that contain small features and bugs which have a relatively limited scope. This is a great place to get started, gain experience, and get familiar with our contribution process.
  213. ### Help Wanted
  214. We also have [help wanted](https://github.com/openathleteorg/openathlete/issues?q=is:issue+is:open+label:%22help+wanted%22) issues that are perfect for contributors looking to make a bigger impact.
  215. ### Contributors
  216. <a href="https://github.com/openathleteorg/openathlete/graphs/contributors">
  217. <img src="https://contrib.rocks/image?repo=openathleteorg/openathlete" />
  218. </a>
  219. ### Translations
  220. Don't code but still want to contribute? Join our [Discord community](https://discord.gg/j4PP6tDwuP) and help translate OpenAthlete into your language.
  221. ## Repo Activity
  222. <img width="100%" src="https://repobeats.axiom.co/api/embed/99c5ba879a6c63bdd522bb53ca2a134a080a0a4b.svg" />
  223. <!-- ACKNOWLEDGEMENTS -->
  224. ## Acknowledgements
  225. Special thanks to these amazing projects which help power OpenAthlete:
  226. - [React](https://react.dev/)
  227. - [NestJS](https://nestjs.com/)
  228. - [TypeScript](https://www.typescriptlang.org/)
  229. - [Prisma](https://www.prisma.io/)
  230. - [Tailwind CSS](https://tailwindcss.com/)
  231. - [ShadCN UI](https://ui.shadcn.com/)
  232. - [Vite](https://vitejs.dev/)
  233. - [PostgreSQL](https://www.postgresql.org/)
  234. ---
  235. <p align="center">
  236. Made with ❤️ by athletes, for athletes
  237. </p>
  238. <p align="center">
  239. If you self-host OpenAthlete, a <a href="https://buymeacoffee.com/openathlete">coffee</a> helps keep it maintained.
  240. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.