kgh

kgh is a GitHub-native CLI for Kaggle workflows. It resolves a named target from repository config, prepares a Kaggle kernel run, and can optionally submit the resulting artifact to a Kaggle competition.

The local CLI is dry-run first by default, so you can inspect the resolved execution JSON before you run anything on Kaggle.

Installation

You can install via build binaries or release artifacts which are published on GitHub Releases. You can run without installation as well.

# Build from source
go build ./cmd/kgh
# Run without installing
go run ./cmd/kgh

Nix

nix develop
nix build
nix flake check

Quick Start

Requirements:

• Go 1.25.x if you are building from source
• Kaggle CLI and Kaggle credentials for live runs
• access to the competition and datasets referenced by your target

Run one happy path locally:

cp .kgh/config_example.yaml .kgh/config.yaml
go run ./cmd/kgh run --target issue7-e2e
go run ./cmd/kgh run --target issue7-e2e --dry-run=false

The first command resolves the target and prints dry-run JSON. The second performs a live Kaggle workflow.

Further Docs

• Documentation index
• Setup guide
• Config guide
• Local run guide
• GitHub trigger guide
• Contributing

Development

For contributor workflow, validation commands, and repository conventions, see CONTRIBUTING.md.