Skip to main content

Kaizo

Kaizo is a declarative YAML-based configuration parser for Python. It allows you to dynamically load, resolve, and execute Python objects, functions, and plugins from YAML configuration files.

Key features:

  • Cross-file imports
  • Lazy execution
  • Result caching
  • Plugin dispatch
  • Variable references
  • Local Python module support

Installation

Install Kaizo via pip:

pip install kaizo

Or install from source:

git clone https://github.com/NaughtFound/kaizo.git
cd kaizo
pip install -e .

Requirements:

  • Python 3.12+
  • PyYAML

Quick Start

Create a simple configuration file hello.yaml:

hello:
  module: builtins
  source: print
  args:
    - "Hello Kaizo"

Load and execute it:

from kaizo import ConfigParser

parser = ConfigParser("hello.yaml")
config = parser.parse()

# Accessing the entry automatically resolves and executes it
config["hello"]  # Outputs: Hello Kaizo

Documentation

Full documentation, including configuration, parser architecture, plugins, and utilities, is available in the docs:

Kaizo Documentation


Contributing

Contributions are welcome! Please submit issues or pull requests via GitHub.


License

Apache License

Metadata

Release files for kaizo 1.6.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kaizo 1.6.3
File Size Uploaded
kaizo-1.6.3.tar.gz 16.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for kaizo 1.6.3
File Interpreter ABI Platform
kaizo-1.6.3-py3-none-any.whl Python 3 none any Details

Total release size: 31.1 kB

Release files / kaizo-1.6.3.tar.gz

Download URL kaizo-1.6.3.tar.gz
Size 16.9 kB
Tags Source
SHA-256 checksum
How to use checksums
47633e5e7a1d4db765028c3f5c7d5df318cfcec2f300c9446f7f1de8050f6b1e
BLAKE2b-256 checksum
How to use checksums
0f527ca31de5fd95e1caef0fa7ce81e4f12a22754ebc0ab0978f914f1572d1b8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

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 Jul 19, 2026.

Transparency log

Release files / kaizo-1.6.3-py3-none-any.whl

Download URL kaizo-1.6.3-py3-none-any.whl
Size 14.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
05a3d0b107804739a7967549cc1933a5f4eef47cf30c3dbb6a574243b08338a2
BLAKE2b-256 checksum
How to use checksums
5ff92be1be706402bc98644593d8b35066014a640496ebfcd9dc52b4d4c81446
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

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 Jul 19, 2026.

Transparency log

Release history Release notifications | RSS feed

1.7.1

2 release files

1.7.0

2 release files

This release

1.6.3 This release

2 release files

1.6.2

2 release files

1.6.1

2 release files

1.6.0

2 release files

1.5.5

2 release files

1.5.4

2 release files

1.5.3

2 release files

1.5.2

2 release files

1.5.1

2 release files

1.5.0

2 release files

1.4.0

2 release files

1.3.6

2 release files

1.3.5

2 release files

1.3.4

2 release files

1.3.3

2 release files

1.3.2

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page