Bat Jester

A program that counts the number of soccer ball juggles recorded in an audio file. The model developed in this repo is intended to be used in a phone application (code not stored in this repo).

Environment Setup

• Clone the GitHub repo.
  • Command line

  git clone https://github.com/middlec000/bat_jester_model_training.git

  • Or use the GitHub desktop app
• Use uv to manage Python and Python packages.
  • Install uv on your system - see here.
  • Ensure uv is installed:

  uv --version

  • Navigate to the project directory if you are not already in it

  cd .../bat_jester_model_training/

  • Use uv to install python and the packages for this project:

  uv sync

  • To add a new package:

  uv add <package_name>

• Download the data (see Contribute/Data Access) and store it in /bat_jester_model_training/data/
• Disregard the flake.nix and flake.lock files unless you are using nix for package management on your machine.

Docs

• Market Research
• Development Plan
• Previous Approach

Contribute

Would love to collaborate on this project!

• Data Access
  • Email me
• Communication Channel
  • Google Chat Space
• Development git branching pattern
  • Branch from main with branch name describing branch purpose

  git switch main
  git branch clip_videos_on_voice_commands

  • When the work is ready, open a pull request in GitHub with target branch=main