Kaggle

35 tools available

Kaggle is a platform for data science and machine learning competitions, offering datasets, notebooks, and a collaborative community.

Connect Kaggle to Definable to route to the best model per task, mix providers in one workflow, fall back on rate-limits. Personas call Kaggle's 35 tools directly from chat or scheduled flows. Add it to your persona's available models and route requests to it where it fits best.

Common workflows with Kaggle

01

Multi-provider routing

  1. Persona decides which model fits
  2. Calls this provider when its strengths apply
  3. Falls back to alternatives on rate-limits
02

Specialised pipeline

  1. Use this provider for one stage
  2. Pipe to a different model for the next
  3. Combine outputs in the response

Kaggle actions 35

Every Kaggle action below is a callable tool any Definable persona can invoke.

Download competition data files

Downloads all data files for a Kaggle competition as a single zip archive. Returns the local file path where the zip was saved. Note: You must have accepted the competition's rules on Kaggle's website before downloading (403 error if not accepted).

Submit Competition Entry

Submit an entry to a Kaggle competition using a previously uploaded file. Prerequisites: 1. You must have accepted the competition rules on Kaggle's website 2. You must have uploaded your submission file and obtained a blob_file_tokens (use Kaggle's file upload API endpoint first) This action performs the final submission step after file upload. The blob token identifies your uploaded file and associates it with your competition submission.

Get Kaggle Config Directory

Tool to retrieve the directory of the Kaggle API configuration file. Use when you need to locate the directory containing your kaggle.json credentials.

Initialize Kaggle Configuration

Initialize Kaggle API client configuration. This action sets up the necessary configuration file for Kaggle API access by first attempting to use the Kaggle CLI's 'kaggle config init' command. If the CLI is unavailable, it falls back to creating a kaggle.json file at ~/.kaggle/kaggle.json (or $KAGGLE_CONFIG_DIR/kaggle.json if that environment variable is set). The action is idempotent - if configuration already exists, it will not overwrite it. No parameters are required; the action uses environment variables and metadata when available. Run this before other Kaggle actions when credentials are missing or when KAGGLE_CONFIG_VIEW returns empty/error output.

List Kaggle Configuration Keys

Tool to list local Kaggle API configuration keys. Use when you need to see which configuration options are set without revealing values.

Get Kaggle Config Path

Tool to retrieve local Kaggle API configuration file path. Use when you need to know the location of the Kaggle config before operations.

Reset Kaggle Configuration

Tool to reset local Kaggle CLI configuration to defaults. Clears CLI-managed keys ('competition', 'path', 'proxy').

Set Kaggle Configuration

Tool to set a Kaggle CLI configuration parameter. Use when updating local CLI settings such as default download path or proxy. Ensure Kaggle CLI is installed.

Unset Kaggle Configuration

Tool to unset a Kaggle CLI configuration parameter. Use when removing local CLI settings such as default download path or proxy. Ensure Kaggle CLI is installed.

View Kaggle Configuration

View local Kaggle API credentials and configuration settings. This action reads Kaggle configuration from local sources (does NOT make API calls to Kaggle). Configuration is retrieved in the following precedence order: 1. kaggle.json file (from KAGGLE_CONFIG_DIR env var, ~/.config/kaggle/, or ~/.kaggle/) 2. 'kaggle config view' CLI output (for proxy/path settings) 3. Environment variables (KAGGLE_USERNAME, KAGGLE_KEY) 4. Authorization header from metadata Use this action to: - Verify Kaggle credentials are configured before making API calls - Check current proxy settings - Debug authentication issues Returns empty strings for username/key if no credentials are found; use KAGGLE_CONFIG_INIT to set up credentials first. Note: username and key are independent — an empty username field does not indicate missing or invalid credentials. WARNING: This action returns sensitive API key data in plain text.

Dataset Create

Create a new Kaggle dataset with metadata. IMPORTANT: Dataset creation requires at least one data file. Ensure files are uploaded before calling this action. The 'id' field must use your authenticated Kaggle username as the owner. Returns the creation status and any message from the Kaggle API.

Kaggle Dataset Init

Tool to initialize a dataset-metadata.json file in a local folder. Use when preparing a dataset folder before uploading to Kaggle.

List Kaggle Dataset Files

Tool to list files in a Kaggle dataset. Use when you need to retrieve paginated file listings by owner and dataset slugs, with optional version and paging controls.

Get Dataset Status

Check the processing status of a Kaggle dataset after creation or version update. This endpoint is used to monitor datasets that are currently being processed by Kaggle's servers. It returns status information for datasets that are actively uploading, processing, or experiencing errors. For already-published datasets, this endpoint typically returns 404 (Not Found), which is expected behavior. Use this tool immediately after creating a new dataset (KAGGLE_DATASET_CREATE) or updating an existing dataset version (KAGGLE_DATASET_VERSION) to check when the dataset becomes ready. Poll this endpoint periodically until the status indicates completion or error.

Create Dataset Version

Create a new version of an existing Kaggle dataset. Prerequisites: - You must own the dataset or have edit permissions - Files must be uploaded first to obtain upload tokens (required for the 'files' parameter) Use this when you have updated files or metadata and need to publish a new version of an existing dataset.

Download competition file

Tool to download a specific data file from a Kaggle competition. Use when you need to retrieve a single file from a competition by specifying the competition slug and filename. Note: You must have accepted the competition's rules on Kaggle's website before downloading.

Download competition leaderboard

Tool to download the entire competition leaderboard as a CSV file packaged in a ZIP archive. Use when you need to analyze or review competition standings and scores.

Download Kaggle Dataset

Tool to download all files from a Kaggle dataset as a zip archive. Supports downloading specific versions by providing the dataset_version_number parameter.

Download Kaggle Dataset File

Tool to download a specific file from a Kaggle dataset. Use when you need to retrieve a single file from a dataset by specifying the owner, dataset, and filename.

Generate Competition Submission URL

Tool to generate a pre-signed URL for uploading competition submission files. Use this before uploading your submission file to Kaggle. This action generates a temporary upload URL and token for submitting to a competition. You must provide the competition ID, file size, and last modified timestamp. After obtaining the URL, upload your submission file to the createUrl, then use the token to finalize the submission.

Get Dataset Metadata

Tool to get comprehensive metadata for a Kaggle dataset including title, description, licenses, and tags. Use when you need detailed information about a dataset's structure, schema, or properties.

Get Model Details

Tool to get a Kaggle model's details including metadata and description. Use when you need information about a specific model on Kaggle.

Get Model Instance Details

Tool to get details for a specific Kaggle model instance (variation). Returns metadata including overview, usage instructions, download URL, version information, and license details. Use when you need to inspect or retrieve information about a specific model variation before downloading or using it.

Kaggle Kernel Init

Initialize a kernel-metadata.json template file in a specified folder. This file is required before pushing/uploading a kernel to Kaggle. The template includes default values for kernel configuration (language, kernel_type, GPU settings, etc.) that can be customized before pushing. Use this when setting up a new Kaggle kernel locally.

Download kernel output

Tool to download the output of a Kaggle kernel. Use when needing the latest kernel results locally.

Get Kernel Status

Get the execution status of a Kaggle kernel (notebook). Returns current status (running, complete, error), timestamps, and output URL. Use this to monitor kernel execution after pushing/submitting a kernel. Note: You need permission to access the kernel - typically only your own kernels or public kernels you have access to.

List competition data files

Tool to list all data files available for a Kaggle competition. Use when you need to retrieve file names, sizes, and metadata for competition datasets before downloading.

List Kaggle Competitions

Tool to list available Kaggle competitions with filters and pagination. Use when you need to discover competitions, search by keywords, or filter by category, group, and sorting options.

List Kaggle Datasets

Tool to list Kaggle datasets with filters and pagination. Use after authenticating with Kaggle API key.

List Kernel Output Files

Tool to list output files for a specific kernel run. Use when you need to retrieve paginated file listings by kernel owner and slug.

List Kaggle Kernels

Tool to list Kaggle kernels (notebooks and scripts) with filters and pagination. Use to discover kernels by search terms, user, language, type, competition, or dataset.

List Model Instance Version Files

Tool to list files for a specific version of a model variation. Use when you need to retrieve files for a particular model framework instance version by owner, model, framework, variation, and version.

List Kaggle Models

Tool to list Kaggle models with optional filters for owner, sorting, search, and pagination. Use to discover available models on Kaggle's platform.

Pull Kernel Code

Tool to pull (download) the source code of a Kaggle kernel to local storage. Use when you need to retrieve a kernel's notebook, script, or metadata files. Optionally include metadata JSON file with kernel configuration details.

View competition leaderboard

Tool to view competition leaderboard information showing rankings and scores of participants. Use when you need to check competition standings, team scores, or analyze leaderboard positions.

Frequently asked questions

What can I automate with Kaggle on Definable?

Anything Kaggle exposes through its API. Common artificial intelligence workflows on Definable include route to the best model per task, mix providers in one workflow, fall back on rate-limits. Personas can call any of the 35 Kaggle tools directly, then chain the result into another integration without you writing code.

How does Kaggle authentication work?

Kaggle uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Kaggle integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 35 Kaggle tools. You only need a separate Kaggle subscription if Kaggle itself charges per seat or per API call.

Is using Kaggle through Definable secure?

Every call from a persona to Kaggle is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Kaggle on Definable?

Sign up for Definable, open the integrations page, find Kaggle, and connect via OAuth or API key. You can immediately attach Kaggle to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Kaggle actions does Definable expose?

Definable exposes all 35 Kaggle actions as callable tools — including `Download competition data files`, `Submit Competition Entry`, `Get Kaggle Config Directory`, plus 32 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Kaggle?

Wire it up in minutes. No coding required.

← All integrations