This release is a pre-release and may not be stable for production use.
Built on Kubernetes. Konduktor uses existing open source tools to build a platform that makes it easy for ML Researchers to submit batch jobs and for administrative/infra teams to easily manage GPU clusters.
How it works
Konduktor uses a combination of open source projects. Where tools exist with MIT, Apache, or another compatible open license, we want to use and even contribute to that tool. Where we see gaps in tooling, we build it.
Architecture
Konduktor can be self-hosted and run on any certified Kubernetes distribution or managed by us. Contact us at founders@trainy.ai if you are just interested in the managed version. We're focused on tooling for clusters with NVIDIA cards for now but in the future we may expand to our scope to support other accelerators.
For ML researchers
- Konduktor CLI & SDK - user friendly batch job framework, where users only need to specify the resource requirements of their job and a script to launch that makes simple to scale work across multiple nodes. Works with most ML application frameworks out of the box.
num_nodes: 100
resources:
accelerators: H100:8
cloud: kubernetes
labels:
kueue.x-k8s.io/queue-name: user-queue
kueue.x-k8s.io/priority-class: low-priority
run: |
torchrun \
--nproc_per_node 8 \
--rdzv_id=1 --rdzv_endpoint=$master_addr:1234 \
--rdzv_backend=c10d --nnodes $num_nodes \
torch_ddp_benchmark.py --distributed-backend nccl
For cluster administrators
- DCGM Exporter, GPU operator, Network Operator - For installing NVIDIA driver, container runtime, and exporting node health metrics.
- Kueue - centralized creation of job queues, gang-scheduling, and resource quotas and sharing across projects.
- Prometheus - For publishing metrics about node health and workload queues.
- OpenTelemetry - For pushing logs from each node
- Grafana, Loki - Visualizations for metrics/logging solution.
Community & Support
Development Setup
Prerequisites
- Python 3.9+ (3.10+ recommended)
- Poetry for dependency management (installation guide)
- kubectl and access to a Kubernetes cluster (for integration/smoke tests)
Quick Start
# Clone the repository
git clone https://github.com/Trainy-ai/konduktor.git
cd konduktor
# Install dependencies (including dev tools)
poetry install --with dev
# Verify installation
poetry run konduktor --help
Running Tests
# Run unit tests
poetry run pytest tests/unit_tests/ -v
# Run smoke tests (requires Kubernetes cluster)
poetry run pytest tests/smoke_tests/ -v
Code Formatting
All code must pass linting before being merged. Run the format script to auto-fix issues:
bash format.sh
This runs:
- ruff - Python linter and formatter
- mypy - Static type checking
Local Kubernetes Cluster (Optional)
For running smoke tests locally, you can set up a kind cluster:
# Install kind and set up a local cluster with JobSet and Kueue
bash tests/kind_install.sh
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file konduktor_nightly-0.1.0.dev20260802110532.tar.gz.
File metadata
- Download URL: konduktor_nightly-0.1.0.dev20260802110532.tar.gz
- Upload date:
- Size: 343.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c137306b5a54bcbb6e7166f293b1b89817debb033df356a71918c2880bd82296
|
|
| MD5 |
701736a0cb3fe090c34c8ea7eaff9bde
|
|
| BLAKE2b-256 |
21450a57a0f5aadde4160c501b216415a8c1708804b2e34be74ee15ae5aa69bd
|
Provenance
The following attestation bundles were made for konduktor_nightly-0.1.0.dev20260802110532.tar.gz:
Publisher:
pypi-nightly-build.yaml on Trainy-ai/konduktor
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
konduktor_nightly-0.1.0.dev20260802110532.tar.gz -
Subject digest:
c137306b5a54bcbb6e7166f293b1b89817debb033df356a71918c2880bd82296 - Sigstore transparency entry: 2322998723
- Sigstore integration time:
-
Permalink:
Trainy-ai/konduktor@0fac1d4ed6f693ad2e6a4f934c4e3deda8d8951e -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Trainy-ai
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
self-hosted -
Publication workflow:
pypi-nightly-build.yaml@0fac1d4ed6f693ad2e6a4f934c4e3deda8d8951e -
Trigger Event:
schedule
-
Statement type:
File details
Details for the file konduktor_nightly-0.1.0.dev20260802110532-py3-none-any.whl.
File metadata
- Download URL: konduktor_nightly-0.1.0.dev20260802110532-py3-none-any.whl
- Upload date:
- Size: 396.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9e360efdb183b8e2a8defd6853a1231df46b8bc1679b37b2616b468d092d9f26
|
|
| MD5 |
2f23ef4dd6a490c6336f2149b2e9d4d1
|
|
| BLAKE2b-256 |
8df8de1e53ad448387bc9de605aa15023dbdf57ca08da3f199ea6d4946263841
|
Provenance
The following attestation bundles were made for konduktor_nightly-0.1.0.dev20260802110532-py3-none-any.whl:
Publisher:
pypi-nightly-build.yaml on Trainy-ai/konduktor
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
konduktor_nightly-0.1.0.dev20260802110532-py3-none-any.whl -
Subject digest:
9e360efdb183b8e2a8defd6853a1231df46b8bc1679b37b2616b468d092d9f26 - Sigstore transparency entry: 2322999321
- Sigstore integration time:
-
Permalink:
Trainy-ai/konduktor@0fac1d4ed6f693ad2e6a4f934c4e3deda8d8951e -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Trainy-ai
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
self-hosted -
Publication workflow:
pypi-nightly-build.yaml@0fac1d4ed6f693ad2e6a4f934c4e3deda8d8951e -
Trigger Event:
schedule
-
Statement type:
