Kleinkram: CLI

Install the package

pip install kleinkram

Run the CLI

klein

Usage

Here are some basic examples of how to use the CLI.

Listing Files

To list all files in a mission:

klein list -p project-name -m mission-name

Uploading Files

To upload all *.bag files in the current directory to a mission:

klein upload -p project-name -m mission-name *.bag

If you would like to create a new mission on upload use the --create flag.

Downloading Files

To download all files from a mission and save them out:

klein download -p project-name -m mission-name --dest out

You can additionally specify filenames or ids if you only want to download specific files.

Instead of downloading files from a specified mission you can download arbitrary files by specifying their ids:

klein download --dest out *id1* *id2* *id3*

For more information consult the documentation.

Development

Clone the repo

git clone git@github.com:leggedrobotics/kleinkram.git
cd kleinkram/cli

Setup the environment

virtualenv -ppython3.10 .venv
source .venv/bin/activate
pip install -e . -r requirements.txt

Install pre-commit hooks

pre-commit install

Run the CLI

klein --help

Run Tests

to run unit tests:

pytest -m "not slow"

to run all tests (including e2e and integration tests):

pytest

For the latter you need to have an instance of the backend running locally. See instructions in the root of the repository for this. On top of that these tests require particular files to be present in the cli/tests/data directory. These files are automatically generated by the cli/tests/generate_test_data.py script.

You also need to make sure to be logged in with the cli with klein login.

Release files for kleinkram 0.59.0.dev20260310081713

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

Source distribution (sdist)

Source distribution for kleinkram 0.59.0.dev20260310081713
File	Size	Uploaded
kleinkram-0.59.0.dev20260310081713.tar.gz	56.9 kB	Mar 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for kleinkram 0.59.0.dev20260310081713
File	Interpreter	ABI	Platform	Reset
kleinkram-0.59.0.dev20260310081713-py3-none-any.whl 72.7 kB Mar 10, 2026	Python 3	none	any	Details

Total release size: 129.6 kB

Release files / kleinkram-0.59.0.dev20260310081713.tar.gz

Download URL	kleinkram-0.59.0.dev20260310081713.tar.gz
Size	56.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`886592579d523fe4e1c6a463e7a007b8d3bbfd70a99569943777f7b4216c8d75`
BLAKE2b-256 checksum How to use checksums	`2c50914e37ffa6e888aeeb72b1be5096e8b21d6ba813ba41b483d55c304bd294`
Upload date	Mar 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Release files / kleinkram-0.59.0.dev20260310081713-py3-none-any.whl

Download URL	kleinkram-0.59.0.dev20260310081713-py3-none-any.whl
Size	72.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`fe67ff232d7bbe596bb5707b6bd27bf31dfb4cd7b9a5ae9068d84a394907e445`
BLAKE2b-256 checksum How to use checksums	`033ea7c93a8f03534a4c2fc84bf1d46ec47e279efb719635b6291cd9d2f0543c`
Upload date	Mar 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.7`