Program Planner

Periodized program planner and recommendation generator for Fullsterkur.ai.

Table of Contents

1. Tech Stack
2. Getting Started
   • Prerequisites
   • Installation
   • Running the Service
3. Project Structure

---

Tech Stack

Python Language the service and model pipeline are built in.	scikit-learn Trains the models behind periodization recommendations.	pandas / NumPy Data loading, cleaning, and feature preparation for training.	FastAPI Serves the trained model and planning logic to the Mobile app over HTTP.

---

Getting Started

Prerequisites

• Python

Installation

1. Clone the repo

   git clone https://github.com/fullsterkur-ai/program-planner.git
   cd program-planner
   

2. Create and activate a virtual environment

   python -m venv .venv
   

   Windows:

   .venv\Scripts\activate
   

   macOS/Linux:

   source .venv/bin/activate
   

3. Install dependencies

   pip install -r requirements.txt
   

Running the Service

uvicorn main:app --reload

---

Project Structure

program-planner/
├── artifacts/   # Trained models and training outputs
├── data/        # Datasets
├── ml/          # Model training code
└── requirements.txt

---

See Also

• Main repository README: project overview, architecture, components, and team
• DEVELOPMENT.md: coding conventions and branching/merging strategy

(back to top)