Pre-release

This release is a pre-release and may not be stable for production use.

logo-kiso

Kiso

Describe your experiment in a YAML file — Kiso handles provisioning, software setup, execution, and result collection.

License Latest Python Versions PyPi Downloads Code Style Contributors

Why Kiso

Setting up experiments across cloud and edge testbeds typically means writing custom provisioning scripts, manually installing software on remote nodes, and stitching together execution logic for each new environment. This work is repetitive, error-prone, and hard to reproduce.

Kiso replaces that with a single declarative configuration file. The same experiment definition runs on Chameleon Cloud, FABRIC, or a local Vagrant VM — no changes to your experiment code required.

Quick Start

Install Kiso with the extra for your testbed:

pip install kiso[vagrant]    # local VMs — good for development
pip install kiso[fabric]     # FABRIC testbed
pip install kiso[chameleon]  # Chameleon Cloud and Chameleon Edge (same package, different OpenRC files)
pip install kiso[all]        # all testbeds

Then run your experiment:

# 1. Validate the config
kiso check experiment.yml

# 2. Provision and configure
kiso up experiment.yml

# 3. Run experiments
kiso run experiment.yml

# 4. Collect results, then tear down
kiso down experiment.yml

See the Your first experiment tutorial for a complete walkthrough, or use the experiment template to scaffold a new experiment.

What's Supported

Category	Options
Testbeds	Vagrant, FABRIC, Chameleon Cloud, Chameleon Edge
Software	Docker, Apptainer, Ollama
Deployment	HTCondor
Experiments	Pegasus workflows, Shell scripts

New testbeds, software, and experiment types can be added as plugins via Python entry points. See Extending Kiso.

Documentation

Your first experiment — install Kiso and run a working experiment end-to-end
Multi-testbed experiment — span FABRIC and Chameleon simultaneously
Concepts — understand sites, labels, software, deployments, and experiments
Config file reference — every supported configuration key
Extending Kiso — add custom testbeds, software, and experiment types
Full documentation

Contributing

Contributions are welcome. To get started:

git clone https://github.com/pegasus-isi/kiso.git
cd kiso
pip install -e ".[all]"
pre-commit install

Please follow conventional commits for commit messages. Open an issue before submitting large changes.

References

Pegasus Workflow Management System — scientific workflow engine used to define and execute experiments in Kiso
EnOSlib — infrastructure management library that Kiso builds on for provisioning and remote execution
Chameleon Cloud — NSF-funded cloud testbed supported by Kiso; includes both bare-metal nodes (CHI@UC, CHI@TACC) and edge devices (CHI@Edge) under the same project allocation, each with its own OpenRC credentials file
FABRIC — nationwide programmable research infrastructure supported by Kiso
Vagrant — tool for managing local VMs; used by Kiso for local development without a cloud account
VirtualBox — virtualization platform used as the default Vagrant backend

Funding

Kiso is funded by the National Science Foundation (NSF) under award 2403051.

License

Apache 2.0 © Pegasus ISI

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kiso-0.1.0b0.tar.gz (89.2 kB view details)

Uploaded Jul 18, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

kiso-0.1.0b0-py3-none-any.whl (104.8 kB view details)

Uploaded Jul 18, 2026 Python 3

File details

Details for the file kiso-0.1.0b0.tar.gz.

File metadata

Download URL: kiso-0.1.0b0.tar.gz
Upload date: Jul 18, 2026
Size: 89.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for kiso-0.1.0b0.tar.gz
Algorithm	Hash digest
SHA256	`e23f0b35b7f6a0f28100229a591b945242b9d2c21d2516d09456241fb712ad2c`
MD5	`9d81287c889ab667592ee6134a833b0d`
BLAKE2b-256	`81cad0f93eea249e0964cbc3bc896a963b1d8f9ae82adf7664e7117ba0aff333`

See more details on using hashes here.

Provenance

The following attestation bundles were made for kiso-0.1.0b0.tar.gz:

Publisher: release.yaml on pegasus-isi/kiso

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: kiso-0.1.0b0.tar.gz
- Subject digest: e23f0b35b7f6a0f28100229a591b945242b9d2c21d2516d09456241fb712ad2c
- Sigstore transparency entry: 2192989004
- Sigstore integration time: Jul 18, 2026
Source repository:
- Permalink: pegasus-isi/kiso@fc362d919957c26e927f0293e31b952c64a526c3
- Branch / Tag: refs/tags/v0.1.0b0
- Owner: https://github.com/pegasus-isi
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yaml@fc362d919957c26e927f0293e31b952c64a526c3
- Trigger Event: push