arkitekt-spec
The wire format of an Arkitekt app: one definition of what an app is, shared by everything that produces or consumes it.
| Model | What it is | Produced by | Consumed by |
|---|---|---|---|
AppManifest, Requirement |
who the app is, which services it needs | arkitekt (from the App) |
kabinet |
Inspection |
what the app declares (rekuest's action language, carried as JSON) | arkitekt inspect all, inside the image |
arkitekt's plugin CLI, kabinet |
Selector (cpu, ram, cuda, rocm, oneapi, label) |
where a flavour may run | a flavour's config.yaml |
kabinet, deployers |
DeploymentsFile |
.arkitekt/deployments.yaml, the images a repo publishes |
arkitekt plugin publish |
kabinet's repo scan |
It depends only on pydantic and pyyaml. It deliberately does not depend on rekuest: the implementations, states, locks and bloks inside an inspection are rekuest's language, and each side validates them with its own rekuest models.
Compatibility
Every envelope model ignores unknown keys. An inspection is written by the arkitekt inside
an image and read by the host CLI, and deployments.yaml is written by the CLI and read by a
kabinet server that upgrades on its own schedule. Adding a field is therefore a minor change
an older reader survives. A change an older reader must refuse bumps spec_version.
Selectors are the exception: they refuse unknown keys, because they are written by hand and a typo must not silently widen a placement constraint.
from arkitekt_spec import load_deployments, dump_deployments
file = load_deployments(open(".arkitekt/deployments.yaml").read())
python -m arkitekt_spec prints the JSON Schema. The committed snapshot in
tests/fixtures/deployments.schema.json makes every format change show up in review.
1 maintainer
Metadata
1 maintainer
Release files for arkitekt-spec 1.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| arkitekt_spec-1.2.0.tar.gz | 146.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| arkitekt_spec-1.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 327.7 kB
Release files / arkitekt_spec-1.2.0.tar.gz
| Download URL | arkitekt_spec-1.2.0.tar.gz |
|---|---|
| Size | 146.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
dff2eb9106af665dcb4e4f7876346c00cf58609c5c5b5f67b3edd4930fe51572
|
|
BLAKE2b-256 checksum How to use checksums |
44516e4e60797f57b8cd3cb53c731912b57fabf9b0d731676f043cd216987232
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","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 / arkitekt_spec-1.2.0-py3-none-any.whl
| Download URL | arkitekt_spec-1.2.0-py3-none-any.whl |
|---|---|
| Size | 181.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d4175a93676044c558231ae555f0f810b72b7ec408a7b2d12b23929eb9424de3
|
|
BLAKE2b-256 checksum How to use checksums |
d5b9bce4f956331cbee49990d80ac7a03f2c5f8f16af7acf230a878c4bb61b77
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","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}
|
