Access Kaggle resources anywhere
Project Links
Meta
Author: Kaggle
Requires Python: >=3.11
Classifiers
License
- OSI Approved :: Apache Software License
Operating System
- OS Independent
Programming Language
- Python :: 3
Kaggle CLI
The official CLI to interact with Kaggle.
Key Features
Some of the key features are:
- List competitions, download competition data, submit to a competition.
- List, create, update, download or delete datasets.
- List, create, update, download or delete models & model variations.
- List, update & run, download code & output or delete kernels (notebooks).
Installation
Install the kaggle package with pip:
pip install kaggle
Additional installation instructions can be found here.
Quick start
Explore the available commands by running:
kaggle --help
See the User documentation for more examples & tutorials.
Development
Prerequisites
We use hatch to manage this project.
Follow these instructions to install it.
Run kaggle from source
Option 1: Execute a one-liner of code from the command line
hatch run kaggle datasets list
Option 2: Run many commands in a shell
hatch shell
# Inside the shell, you can run many commands
kaggle datasets list
kaggle competitions list
...
Lint / Format
# Lint check
hatch run lint:style
hatch run lint:typing
hatch run lint:all # for both
# Format
hatch run lint:fmt
Tests
Note: These tests are not true unit tests and are calling the Kaggle web server.
# Run against kaggle.com
hatch run test:prod
# Run against a local web server (Kaggle engineers only)
hatch run test:local
Integration Tests
To run integration tests on your local machine, you need to set up your Kaggle credentials. You can do this by following the authentication instructions.
After setting up your credentials, you can run the integration tests as follows:
hatch run test:integration
Changelog
See CHANGELOG.
Contributing
See CONTRIBUTING.md.
License
The Kaggle CLI is released under the Apache 2.0 license.
2.0.0
Feb 11, 2026
1.8.4
Feb 05, 2026
1.8.3
Dec 23, 2025
1.8.2
Nov 24, 2025
1.8.0
Nov 21, 2025
1.7.4.5
May 08, 2025
1.7.4.2
Mar 14, 2025
1.7.4.1
Mar 13, 2025
1.7.4
Mar 11, 2025
1.7.3b1
Feb 21, 2025
1.7.3b0
Feb 06, 2025
1.6.17
Jul 24, 2024
1.6.15
Jul 23, 2024
1.6.14
May 17, 2024
1.6.12
Apr 12, 2024
1.6.11
Apr 05, 2024
1.6.10
Apr 05, 2024
1.6.9
Apr 05, 2024
1.6.8
Mar 25, 2024
1.6.6
Feb 13, 2024
1.6.5
Feb 06, 2024
1.6.4
Jan 30, 2024
1.6.3
Jan 12, 2024
1.6.2
Jan 09, 2024
1.6.1
Jan 08, 2024
1.6.0
Jan 05, 2024
1.6.0a6
Sep 19, 2023
1.6.0a5
Aug 02, 2023
1.6.0a4
Jul 07, 2023
1.6.0a3
Jul 06, 2023
1.6.0a2
Jun 13, 2023
1.6.0a0
Jun 07, 2023
1.5.16
Jul 17, 2023
1.5.15
Jun 30, 2023
1.5.14
Jun 29, 2023
1.5.13
Mar 01, 2023
1.5.12
Mar 13, 2021
1.5.10
Nov 30, 2020
1.5.9
Oct 21, 2020
1.5.8
Sep 03, 2020
1.5.7
Sep 01, 2020
1.5.6
Sep 19, 2019
1.5.5
Jul 30, 2019
1.5.4
May 28, 2019
1.5.3
Feb 20, 2019
1.5.2
Jan 28, 2019
1.5.1.1
Dec 05, 2018
1.5.1
Dec 05, 2018
1.5.0
Oct 25, 2018
1.4.7.1
Aug 28, 2018
1.4.7
Aug 28, 2018
1.4.6
Aug 07, 2018
1.4.5
Aug 01, 2018
1.4.4
Jul 30, 2018
1.4.3
Jul 30, 2018
1.4.2
Jul 20, 2018
1.4.1
Jul 20, 2018
1.4.0
Jul 19, 2018
1.3.12
Jun 25, 2018
1.3.11.1
Jun 12, 2018
1.3.11
Jun 12, 2018
1.3.10
Jun 10, 2018
1.3.9.1
Jun 09, 2018
1.3.9
Jun 08, 2018
1.3.8
May 18, 2018
1.3.7
May 18, 2018
1.3.6
May 07, 2018
1.3.5
May 04, 2018
1.3.4
Apr 30, 2018
1.3.3
Apr 26, 2018
1.3.2.1
Apr 24, 2018
1.3.2
Apr 24, 2018
1.3.1
Apr 19, 2018
1.3.0
Apr 18, 2018
1.2.1
Apr 17, 2018
1.1.0
Mar 20, 2018
1.0.5
Feb 02, 2018
1.0.4
Jan 31, 2018
1.0.3
Jan 31, 2018
1.0.2
Jan 31, 2018
1.0.1
Jan 31, 2018
1.0.0
Jan 30, 2018
Wheel compatibility matrix
Files in release
Extras:
None
Dependencies:
bleach
kagglesdk
(<1.0,>=0.1.15)
packaging
protobuf
python-dateutil
python-slugify
requests
tqdm
urllib3
(>=1.15.1)