The Kraken build system
Kraken is a build system, but not in the traditional sense. It's focus is on the orchestration of high-level tasks, such as organization of your repository configuration, code generation, invoking other build systems, etc. It is not a replacement for tools like Uv, Cargo or CMake.
Requirements
- CPython 3.10+
Getting started
Currently, Kraken's OSS components are not very well documented and do not provide a convenient way to get started. However, if you really want to try it, you can use the following steps:
Install kraken-wrapper (e.g. with Uv) to get access to the krakenw command-line tool.
Create a .kraken.py script in your project's root directory.
Run krakenw lock to install kraken-build for your project in build/.kraken/venv and generate a kraken.lock file.
Run krakenw run lint to run the linters.
Note that you can also use the
krakenCLI (instead ofkrakenw), however this will disregard thebuildscript()function, will not use the lock file and will use the version of Kraken that was installed globally.
Development
This repository uses Uv, but not currently a Uv-workspace because Kraken does not support that, yet. You may
want to use a released version of krakenw instead of the live version in kraken-wrapper/ to interact with this
repository. You can use Mise to install all the tools you need.
$ mise install
$ eval "$(mise activate)"
$ krakenw run fmt lint test
Release process
A release must be created by a maintainer that has write access to the develop branch.
$ ./scripts/bump.py X.Y.Z --release
The packages are published to PyPI from CI.
2 maintainers
Release files for kraken-build 0.52.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| kraken_build-0.52.1.tar.gz | 335.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| kraken_build-0.52.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 594.2 kB
Release files / kraken_build-0.52.1.tar.gz
| Download URL | kraken_build-0.52.1.tar.gz |
|---|---|
| Size | 335.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
744ad429eb8ed001d58138fa768f06d72c41a09af9198dfdce526c6d15b21d5a
|
|
BLAKE2b-256 checksum How to use checksums |
a02e729474eabaf6b7062e437d88f903e2b4a75c5f04429e56fea7c2059fc8c0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 12, 2026.
Transparency logRelease files / kraken_build-0.52.1-py3-none-any.whl
| Download URL | kraken_build-0.52.1-py3-none-any.whl |
|---|---|
| Size | 259.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f5c16d1230ca2a04825fb0372b185b35a8cc1910e34f8a926d1d1de91ff2ba7c
|
|
BLAKE2b-256 checksum How to use checksums |
21b8fdc5bf6d9d10a5157ac1b288a0ff0708b7cb5ecd62c80256976bd5e2e1c0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 12, 2026.
Transparency log
