GitHub action to automatically generate graphs of your submissions to Kaggle competitions and display them in your Github repository’s README to track your progress.

See it in action here.

1. Add the KAGGLE_KEY secret to your GitHub repository under Settings > Secrets > Add a new secret.
2. Define a GitHub workflow by adding a .github/workflow/kaggle-graph.yaml to your repository using the template below:

name: Kaggle Graph Generation

on:
  push:
    branches: master
  schedule:
    - cron:  '00 00 * * *'

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Git Checkout
        uses: actions/checkout@v2
      - name: Kaggle Graph Generation
        uses: OliverSieweke/kaggle-graph@v0.1.0
        with:
          KAGGLE_KEY: ${{ secrets.KAGGLE_KEY }}
          KAGGLE_USERNAME: oliversieweke
          KAGGLE_COMPETITION_ID: titanic
      - name: Git Auto Commit
        uses: stefanzweifel/git-auto-commit-action@v4.1.6
        with:
          commit_message: Automatic Kaggle graph generation

3. Add the graph to your README:

• Markdown:

  [!Kaggle Submissions Graph](./kaggle-submissions-graph.png)

• reStructuredText:

  .. image:: ./kaggle-submissions-graph.png
      :alt: Kaggle Submissions Graph

NB 1:

• The KAGGLE_KEY key can be generated on Kaggle under My Profile > Edit Profile > API > Create New Api Token.
• The KAGGLE_USERNAME can be found on Kaggle under My Profile > Edit Profile.
• The KAGGLE_COMPETITION_ID can be read from the Kaggle competition's URL.

NB 2:

Kaggle Graph is designed to be used in conjunction with the following GitHub actions:

• checkout
• git-auto-commit

The action can be further configured over the input keys below:

• Documentation