Crunch CLI

This Python library is designed for the Crunch Hub, offering convenient access to competition's data and enabling effortless submission. When utilized in the command-line interface (CLI), its goal is to deliver a user experience akin to GitHub, enabling you to seamlessly push the code from your local environment.

Installation

Use pip to install the crunch-cli.

pip install crunch-cli --upgrade

Usage

Setup your environment

Go to any competition's page and click on the 'Submit' section. Then copy and paste the command into your terminal.

Reveal your token (animation)

Write your model

import crunch
crunch_tools = crunch.load_notebook()

# load the data
data = crunch_tools.load_data()

# define your model
def train(): ...
def infer(): ...

# test your model
crunch_tools.test()

[!TIP] We always recommend trying the quickstarter, which already contains a working model to help you get started in minutes!

Detecting the environment

Being able to detect whether you are running inside the Runner allows you to configure your programme more precisely.

import crunch

if crunch.is_inside_runner:
  print("running inside the runner")
else:
  print("running elsewhere")

  model.enable_debug()
  logger.set_level("TRACE")

Submit with Crunch CLI

Usage: crunch push [OPTIONS]

  Send the new submission of your code.

Options:
  -m, --message TEXT      Specify the change of your code. (like a commit message, limited to 1000 characters)
  --main-file TEXT        Entrypoint of your code.  [default: main.py]       
  --model-directory TEXT  Directory where your model is stored.  [default: resources]
  --export TEXT           Copy the `.tar` to the specified file.
  --no-pip-freeze         Do not do a `pip freeze` to know preferred packages version.
  --dry                   Prepare file but do not really create the submission.

Contributing

Pull requests are always welcome! If you find any issues or have suggestions for improvements, please feel free to submit a pull request or open an issue in the GitHub repository.

License

MIT

Metadata

Release files for crunch-cli 12.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for crunch-cli 12.0.0
File	Size	Uploaded
crunch_cli-12.0.0.tar.gz	86.5 kB	Aug 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for crunch-cli 12.0.0
File	Interpreter	ABI	Platform	Reset
crunch_cli-12.0.0-py3-none-any.whl 113.7 kB Aug 28, 2026	Python 3	none	any	Details

Total release size: 200.2 kB

Release files / crunch_cli-12.0.0.tar.gz

Download URL	crunch_cli-12.0.0.tar.gz
Size	86.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`c1cc0076c47b34d5da86b1e10268d3ee4074d223250eb1af920a7f21e0bce5dc`
BLAKE2b-256 checksum How to use checksums	`586fc2f57ab8a6d8cae173dc685b94953b7840c901702ae145eff6f460e0d7bc`
Upload date	Aug 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Release files / crunch_cli-12.0.0-py3-none-any.whl

Download URL	crunch_cli-12.0.0-py3-none-any.whl
Size	113.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9474595a10077dd38a7bdf93523d0c8d8a4a514e29f37024f6bfc2953fbb72c4`
BLAKE2b-256 checksum How to use checksums	`1d407d59531d7cb4b75c0a41c45e131ed6845c3171b27e2ac8b497b527ee75dc`
Upload date	Aug 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.14`