Openathlete

The open-source, AI-powered endurance training platform.

Generate Convert Improve

Install / Use

/learn @openathleteorg/Openathlete

About this skill

Quality Score

0/100

README

<a href="https://github.com/openathleteorg/openathlete"> <img src="/doc/imgs/openathlete-showcase.png" alt="OpenAthlete Logo"> </a> <h3 align="center">OpenAthlete</h3> The open-source, AI-powered endurance training platform. <a href="https://openathlete.org">Learn more »</a> <a href="https://discord.gg/j4PP6tDwuP">Discord</a> · <a href="https://openathlete.org">Website</a> · <a href="https://docs.openathlete.org">Documentation</a> · <a href="https://api.openathlete.org/docs">API Docs</a> · <a href="https://github.com/openathleteorg/openathlete/issues">Issues</a> <a href="https://github.com/openathleteorg/openathlete/stargazers"><img src="https://img.shields.io/github/stars/openathleteorg/openathlete" alt="Github Stars"></a> <a href="https://github.com/openathleteorg/openathlete/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-AGPLv3-purple" alt="License"></a> <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> <a href="https://testflight.apple.com/join/1hBg4mR1"><img src="https://img.shields.io/badge/TestFlight-iOS%20App-blue" alt="iOS App"></a> <a href="https://api.openathlete.org/docs"><img src="https://img.shields.io/badge/API-Swagger-green" alt="API Docs"></a> <a href="https://docs.openathlete.org"><img src="https://img.shields.io/badge/Docs-Online-brightgreen" alt="Documentation"></a> <a href="https://discord.gg/j4PP6tDwuP"><img src="https://img.shields.io/badge/Discord-Community-5865F2" alt="Discord"></a> <a href="https://github.com/openathleteorg/openathlete/issues?q=is:issue+is:open+label:%22help+wanted%22"><img src="https://img.shields.io/badge/Help%20Wanted-Contribute-blue"></a> <a href="https://github.com/openathleteorg/openathlete/issues?q=is:issue+is:open+label:%22good+first+issue%22"><img src="https://img.shields.io/badge/Good%20First%20Issue-Start%20Here-green"></a>

About the Project

Training infrastructure for absolutely everyone

The open-source, AI-powered endurance training platform. You are in charge of your own data, training plans, and performance optimization.

Training platforms are awesome. They make our athletic lives easier. We use them for tracking workouts, planning training sessions, and monitoring progress. However, most tools are very limited in terms of control, customization, and data ownership.

That's where OpenAthlete comes in. Self-hosted or cloud-hosted. Privacy-first by design. API-driven and ready to be deployed on your own domain. Full control of your training data and AI-powered insights.

Key Features

🤖 AI-Powered Training - Generate workouts, analyze performance, and get intelligent training suggestions
📊 Comprehensive Tracking - Track workouts, visualize progress, and monitor fatigue metrics (CTL/ATL/TSB)
🔗 Device Integrations - Connect with Strava, Garmin, Suunto, Polar, Coros, and more
🎤 Voice Feedback - Record post-session voice notes analyzed by AI for tone, stress, and motivation
👨‍🏫 Coach Mode - Hybrid coaching system where coaches can validate AI adjustments
📱 Mobile Apps - Native iOS (on TestFlight) and Android (coming soon) apps for on-the-go training management
🔒 Privacy-First - Your data stays yours. Self-hostable with full control
🌐 Open Source - Transparent, extensible, and community-driven

Comparison

Recognition

OpenAthlete is built by athletes, for athletes. We're proud to be part of the open-source community and grateful for all contributors who help make this platform better.

Built With

React 19 - Modern UI framework
NestJS - Scalable Node.js backend
TypeScript - Type-safe development
Prisma - Next-generation ORM
PostgreSQL - Robust database
Tailwind CSS - Utility-first CSS
ShadCN UI - Beautiful component library
Vite - Next-generation frontend tooling
OpenAI - AI-powered training insights

Getting Started

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 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.

Development

Setup

Clone the repo into a public GitHub repository (or fork https://github.com/openathleteorg/openathlete/fork):
```
git clone https://github.com/openathleteorg/openathlete.git
cd openathlete
```
Install packages with pnpm
```
pnpm install
```
Set up your environment variables
- Frontend: Copy apps/web/.env.example to apps/web/.env and update with your configuration
- Backend: Copy apps/api/.env.example to apps/api/.env and update with your configuration
- At minimum, you'll need:
  - DATABASE_URL - PostgreSQL connection string
  - JWT_SECRET - Secret key for JWT tokens (generate with openssl rand -base64 32)
  - VITE_API_URL - Backend API URL (for frontend)
Setup Node version

If your Node version does not meet the project's requirements, use nvm:
```
nvm use
```
You first might need to install the specific version and then use it:
```
nvm install && nvm use
```
Build shared packages
```
pnpm shared build
```
Set up the database using Prisma

In a development environment, run:
```
pnpm database run db:migrate dev
```
In a production environment, run:
```
pnpm database run db:deploy
```
Run (in development mode)
```
pnpm dev
```
This will start:
- Frontend at http://localhost:5173
- Backend API at http://localhost:3000

Development Tips

Run type checking before committing:
```
pnpm tsc:check
```
Format and lint your code:
```
pnpm format:write
pnpm lint:fix
```

Upgrading from earlier versions

Pull the current version:
```
git pull
```
Check if dependencies got added/updated/removed
```
pnpm install
```
Apply database migrations by running one of the following commands:

In a development environment, run:
```
pnpm database run db:migrate dev
```
In a production environment, run:
```
pnpm database run db:deploy
```
Check for .env variables changes

Compare your .env files with the .env.example files to see if new variables were added.
Start the server. In a development environment, just do:
```
pnpm dev
```
For a production build, run for example:
```
pnpm build
pnpm start
```
Enjoy the new version.

Deployment

Docker

OpenAthlete can be deployed using Docker. Docker configurations are provided in the repository.

Requirements

Make sure you have docker & docker compose installed on the server / system.

Running OpenAthlete with Docker Compose

Clone the repository:

   git clone https://github.com/openathleteorg/openathlete.git
cd openathlete

Prepare your configuration: Copy .env.example files and update them:
```
cp apps/api/.env.example apps/api/.env
```

cp apps/web/.env.example apps/web/.env


Update the appropriate values in your `.env` files, then proceed.

3. Start OpenAthlete via docker compose:

```bash
docker compose up -d

Open a browser to your configured URL. The first time you run OpenAthlete, you'll need to create your first user.

Updating OpenAthlete

Stop the OpenAthlete stack
```
docker compose down
```
Pull the latest changes
```
git pull
```
Update env vars as necessary.
Re-start the OpenAthlete stack
```
docker compose up -d
```

Manual Deployment

For detailed deployment instructions, see our self-hosting documentation.

Backend (NestJS)

Build the application:
```
cd apps/api
pnpm install
pnpm build
```
Set up environment variables in .env
Run database migrations:
```
pnpm database run db:deploy
```
Start the server:
```
pnpm start:prod
```

Frontend (React + Vite)

Build the application:
```
cd apps/web
pnpm install
pnpm build
```
Serve the b

Related Skills

bluebubbles

352.0k

Use when you need to send or manage iMessages via BlueBubbles (recommended iMessage integration). Calls go through the generic message tool with channel="bluebubbles".

node-connect

352.0k

Diagnose OpenClaw node connection and pairing failures for Android, iOS, and macOS companion apps

slack

352.0k

Use when you need to control Slack from OpenClaw via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.

prose

352.0k

OpenProse VM skill pack. Activate on any `prose` command, .prose files, or OpenProse mentions; orchestrates multi-agent workflows.