- name
- kaggle-cli
- description
- Use the local Kaggle CLI skill for command guidance, workflows, and troubleshooting across competitions, datasets, kernels/notebooks, models, model variations and versions, inbox file uploads, forums/discussions, benchmarks, configuration, OAuth/API-token authentication, and accelerator quota. Activate this skill when the user asks about kaggle CLI commands, examples, flags, metadata files, download/upload flows, submissions, benchmark tasks, or Kaggle CLI behavior.
# Kaggle CLI
Use this skill to answer or operate on the `kaggle` command-line tool. Treat
this skill and its references as the available command guide.
## Quick Start
```bash
pip install kaggle
kaggle --help
```
Authentication options:
```bash
kaggle auth login
# or set KAGGLE_API_TOKEN
# or place an access token in ~/.kaggle/access_token
# or use legacy ~/.kaggle/kaggle.json credentials
```
## Command Tree
```text
kaggle
├── competitions | c
│ ├── list, files, download, submit, submissions, leaderboard
│ ├── team-submissions, episodes, replay, logs, pages
│ └── topics {list, show}, topic-messages
├── datasets | d
│ ├── list, files, download, init, create, version
│ ├── metadata, status, delete
│ └── topics {list, show}
├── kernels | k
│ └── list, files, init, push|update, pull|get, output, status, logs, delete
├── models | m
│ ├── list, init, create, get, update, delete
│ ├── topics {list, show}
│ └── variations | instances | v | i
│ ├── get, init, create, files, list, update, delete
│ └── versions | v {list, create, download, files, delete}
├── files {upload}
├── forums | f {list, topics {list, show}}
├── benchmarks | b
│ ├── auth, init
│ ├── tasks | t {push, run, list, status, download, log|logs, models, delete, publish}
│ └── topics {list, show}
├── config {view, set, unset}
├── auth {login, print-access-token, revoke}
├── quota
└── search
```
Note: the CLI accepts aliases such as `kernels get` for `kernels pull` and
`kernels update` for `kernels push`. Do not recommend
`models variations versions init`; use `models variations init` for variation
metadata instead.
## Reference Map
Read only the reference needed for the user's task:
- [Competitions](references/competitions.md) - competition discovery, files, downloads, submissions, leaderboards, simulations, pages, topics.
- [Datasets](references/datasets.md) - dataset search, files, downloads, metadata, create/version/status/delete, topics.
- [Kernels](references/kernels.md) - notebook/script discovery, metadata, push/pull, outputs, status, logs, delete.
- [Models](references/models.md) - model records, metadata, create/get/update/delete, model topics.
- [Model Variations](references/model_variations.md) - create and manage framework-specific model variations.
- [Model Variation Versions](references/model_variations_versions.md) - create, list, download, inspect, and delete variation versions.
- [Files](references/files.md) - inbox uploads, resumable uploads, directory compression behavior.
- [Forums](references/forums.md) - global discussion forums, topics, and comments.
- [Benchmarks](references/benchmarks.md) - benchmark auth/init, task push/run/status/download/log/model flows, benchmark topics.
- [Configuration](references/configuration.md) - config file, default path, proxy, default competition.
- [Authentication](references/auth.md) - OAuth login, access token printing, revocation, token/key sources.
- [Quota](references/quota.md) - weekly GPU/TPU accelerator quota.
- [Search](references/search.md) - unified cross-content search over competitions, datasets, notebooks, models, users, and discussions.
## Operating Guidance
- Read only the reference needed for the user's task.
- Prefer `kaggle <group> --help` or `kaggle <group> <command> --help` when a flag
is uncertain in the installed CLI.
- For metadata files, prefer the relevant `init` command to generate a starter
file before editing it.
- Do not invent commands that are not listed in this skill. If live `--help`
output differs, report it as a version-specific difference.
Ver en GitHub