kaggle-api kaggleコマンドの使い方

2018/04/22programming kaggle-api tutorial

kaggle公式のcliツール。kaggleのコンペについて調べたり、データセットのダウンロード、予測結果を送信したりできる

環境

ubuntu: 16.04
python: 3.6
pip: 10.0

概ね以下のREADMEに書いてあることを試している https://github.com/Kaggle/kaggle-api

インストール

コマンドインストール

pip install kaggle

コンフィグ設定

アカウントページからapikeyを発行する

Kaggle: Your Machine Learning and Data Science Communityよりログインして、右上のプロフィール画像、“My Account”の順にクリックする

APIの項目から”Create New API Token”をクリックすると、kaggle.jsonがダウンロードされる

kaggle.json

{"username":"uni-3","key":"xxxxx"}

ダウンロードしたjsonファイルを

~/.kaggle/kaggle.json

に設置して、以下のコマンドを実行

chmod 600 ~/.kaggle/kaggle.json

コマンド例

コンペ一覧表示

たくさん出てくる

kaggle competitions list
ref                                             deadline             category            reward  teamCount  userHasEntered  
----------------------------------------------  -------------------  ---------------  ---------  ---------  --------------  
imagenet-object-detection-challenge             2029-12-31 07:00:00  Research         Knowledge          0           False  
imagenet-object-detection-from-video-challenge  2029-12-31 07:00:00  Research         Knowledge          0           False  
imagenet-object-localization-challenge          2029-12-31 07:00:00  Research         Knowledge          7           False  
titanic                                         2020-04-07 00:00:00  Getting Started  Knowledge      11117            True  
house-prices-advanced-regression-techniques     2020-03-01 23:59:00  Getting Started  Knowledge       5031           False  
...

コンペのデータダウンロード

参加しているコンペについて、データセットをダウンロードできる

kaggle competitions download -c "コンペ名" -w

-w

オプションで現在のディレクトリにダウンロードされる

例）

kaggle competitions download -c talkingdata-adtracking-fraud-detection -w
train.csv.zip: Downloaded 1GB of 1GB1GB
train_sample.csv.zip: Downloaded 1MB of 1MB
test.csv.zip: Downloaded 162MB of 162MB
sample_submission.csv.zip: Downloaded 40MB of 40MB
test_supplement.csv.zip: Downloaded 494MB of 494MB

コンペに予測結果送信

kaggle competitions submit -c talkingdata-adtracking-fraud-detection -f  submit.csv -m "first submit"
Successfully submitted to TalkingData AdTracking Fraud Detection ...:

非公式のfloydwch/kaggle-cliもあるらしい。できることは大体同じ感じ