/running-coach

Smart running coach. Build structured a training plan for runners.

Primary LanguageVue


NeatCoach.

Run smart.

Disclaimer: Before beginning any new exercise program, including the plans generated by the app, it's important to consult with a healthcare professional, especially if you have any pre-existing medical conditions or concerns. The training plans generated by the app are general guidelines and may not be suitable for everyone. Adjustments should be made based on individual fitness levels, goals, and personal preferences. Additionally, listen to your body throughout the training process and modify or stop any activity that causes discomfort or pain. By following this training plan, you acknowledge that you are doing so at your own risk, and neither the author nor any associated parties shall be held responsible for any injuries or health issues that may occur.

About NeatCoach.

NeatCoach is a smart running coach. It will take a distance and minutes and Build well structured a training plan to run the entered distance in the desired minutes by the end of the last week of the training plan.

It will include speed work, tempo runs, and long runs in the plan as suggested by experts.

Additionally, you can save a plan and update your progress on them.

Zen. Screen Shot

Demo

Live demo

Journey

One of my main hobbies is running, I've been training and participating in local 5k races for a couple of years now and I am always looking for training plans to improve my record.

I went through the documentation on workers and pages and followed the instructions to do the project, which was pretty straightforward.

I went to the Model playground to test and modify the prompt until I got the output structure I had in mind.

What model do I use?

@cf/meta/llama-2-7b-chat-int8

What I learned?

  • To create Cloudflare Pages and Workers and to add bindings.
  • Even though I just used one I explored multiple models and tried its capabilities as well as how to use @cloudflare/ai package

What's next?

  • Allow users to store plans online using a DB
  • Train the AI to obtain better plans and take more user inputs like the current pace.
  • Add more widgets.

Built With

I used the following.

Getting Started

Prerequisites

Prerequisite Version
Node.js ~ ^v20.9.0
Cloudflare account --
node -v

Installation

  1. Clone the repo

    git clone https://github.com/jesusantguerrero/running-coach.git neatcoach
  2. Install NPM packages

    cd neatcoach
    npm install
  3. Run preview

    npm run preview
  4. Build

    npm run build

License

Distributed under the MIT License. See LICENSE for more information.