kiso 0.1.0a10

Kiso experiment manager

Kiso

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

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

pip install kiso
kiso check experiment.yml  # validate your config
kiso up experiment.yml     # provision resources and install software
kiso run experiment.yml    # run the experiment
kiso down experiment.yml   # tear down resources

See Getting Started for a complete walkthrough, or use the experiment template to scaffold a new experiment.

What's Supported

Category	Options
Testbeds	Chameleon Cloud, Chameleon Edge, FABRIC, Vagrant
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

• Getting Started — install Kiso and run your first experiment
• Concepts — understand sites, labels, software, deployments, and experiments
• Experiment Configuration — full YAML schema reference
• Example Experiments — real-world experiments built with Kiso
• 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
• 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