Skip to main content

Karotte 🥕

Karotte is an open-source framework for building robust RL environments, made by Preference Model.

Documentation: karotte.dev

Install

Karotte needs Python 3.12+ and uv. Runs go into a VM by default: Apple container on macOS, Firecracker on Linux. docker or podman work too. See Installation and Runtimes for what each needs.

uv tool install karotte

Quick start

Create an environment from the default template and run its example task:

karotte create-env my_env
cd my_env
uv sync --extra dev
uv run setup_data.py
uv run karotte create-run-config --model anthropic/claude-fable-5
export ANTHROPIC_API_KEY=...
uv run karotte run --config run_config.json

karotte run builds the image, runs the task, and writes the transcript to out/transcript.json. karotte dashboard out/ shows it. The quick start explains each step, and Writing tasks shows how to add your own.

Development

just lint
just test
just test-template default

Every merge to main is released. See Developing Karotte.

License

Karotte is under the MIT license. The templates in src/karotte/templates/ are under MIT No Attribution (MIT-0), so environments created from them need no license notice.

Third-party software in built images

Images built from the templates contain third-party software under its own licenses. They are based on Amazon Linux 2023. The language-toolchains template installs GPL and LGPL software (gcc, GnuCOBOL, GNU Prolog, Free Pascal, the libraries bundled with Julia, and others), Amazon Corretto (GPL-2.0 with the Classpath Exception) and Clojure (EPL-1.0) for the languages you enable. Mojo, off by default, has its own license terms; check them for the version you enable. If you distribute a built image, you're responsible for complying with the licenses of the software in it.

Metadata

Release files for karotte 3.0.38

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

Source distribution (sdist)

Source distribution for karotte 3.0.38
File Size Uploaded
karotte-3.0.38.tar.gz 385.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for karotte 3.0.38
File Interpreter ABI Platform
karotte-3.0.38-py3-none-any.whl Python 3 none any Details

Total release size: 862.7 kB

Release files / karotte-3.0.38.tar.gz

Download URL karotte-3.0.38.tar.gz
Size 385.2 kB
Tags Source
SHA-256 checksum
How to use checksums
ebcb0a005bb5a72470444d24e21ca88b542e1694b20ef35f9b011e5b769ce691
BLAKE2b-256 checksum
How to use checksums
6612f20a1fa97b5e616b156df38a7c7123575574c2a1a5747a2606696bb677bf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / karotte-3.0.38-py3-none-any.whl

Download URL karotte-3.0.38-py3-none-any.whl
Size 477.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
55a92be60f881f479504225e0d8d4e165ec27d60597cafcd6bc4ee8307934116
BLAKE2b-256 checksum
How to use checksums
d03af8d4dae3a7b534a2a0e991df5bd92d7995fdb41901dc0a02d658154659da
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

3.0.38 This release

2 release files

3.0.9

2 release files

3.0.7

2 release files

3.0.6

2 release files

3.0.5

2 release files

3.0.4

2 release files

0.0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page