kagitch 1.5.3

kagitch add · kagitch switch · kagitch check

Install

pip install kagitch
kagitch init        # interactive setup wizard (one time)

Requires pip install kaggle and Python 3.8+.

Windows / PowerShell: kagitch init detects $PROFILE for both PowerShell 5.1 and 7+. Run kagitch init -r to print a . $PROFILE reload command.

Config path: %APPDATA%\kagitch\accounts.json on Windows, ~/.config/kagitch/accounts.json on Linux/macOS.

Quick start

kagitch add work      # OAuth login — opens browser
kagitch add personal  # or: kagitch add personal ~/kaggle.json (legacy key)
kagitch 2             # switch to account 2
kagitch check         # check quota for all accounts
kaggle quota          # kaggle CLI follows the switched account
kaggle push kernels -p . # push current folder as a Kaggle kernel

$ kagitch

╭─────────────────── Dashboard ───────────────────╮
│   Active  #1 account1                           │
│                                                 │
│   Run kagitch switch to choose another account. │
╰─────────────────────────────────────────────────╯
┏━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┓
┃   # ┃ Name         ┃  Auth    ┃ Path                         ┃ Status   ┃
┡━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━┩
│   1 │ account1     │   OAuth  │  ~/.kaggle-account1          │ ● active │
│   2 │ account2     │   OAuth  │  ~/.kaggle-account2          │          │
│   3 │ account3     │   OAuth  │  ~/.kaggle-account3          │          │
└─────┴──────────────┴──────────┴──────────────────────────────┴──────────┘

Commands

Kernel commands

kagitch kernel init                      # create kernel-metadata.json interactively
kagitch kernel logs <owner/slug>         # stream kernel logs (no ref = interactive browse)
kagitch kernel output <owner/slug>       # download outputs: pick files on the tree
kagitch kernel output <owner/slug> -a    # download every output file
kagitch kernel output <owner/slug> -p out -f   # target dir + overwrite existing

kagitch kernel output shows the kernel's output structure as an interactive tree with per-file sizes, lets you pick individual files or whole directories (space toggles, a selects/deselects all, arrow keys navigate), streams downloads with a live progress bar, and finishes with a summary card. The kernel picker supports type-to-filter and color-coded statuses. Requires kaggle>=2.2.4 (bundles kagglesdk>=0.1.33).

How it works

Each account lives in ~/.kaggle-<name>/.

The shell wrapper sets KAGGLE_CONFIG_DIR when you switch.

Config stored at:

• Windows: %APPDATA%\kagitch\accounts.json
• Linux/macOS: ~/.config/kagitch/accounts.json