strata
You already have Terraform. The problem is you have eight environment folders — dev, staging, prd, prd-eu, prd-us, dr, sandbox, perf — and they are 90% identical. Every change gets applied to one folder, forgotten in three others, and you only find out when production drifts. strata is a YAML config layer over Terraform, Helm, and scripts that treats your environments as data, not as copy-pasted folders. One source of truth, one command to validate it, one command to deploy it.
Support: GitHub Issues
Quick Start
pipx install xyz-strata # install
strata sln init # scaffold a new config workspace
strata console # interactive guided session
strata validate --file stack/my-environment.yaml # validate before you touch anything
strata deploy run --file deploy/my-environment.yaml # deploy to the target environment
New here? See the feature overview for a practical rundown of what strata does, or the Getting Started guide for the full walkthrough. Run strata --help to see all commands. Dev install: uv sync.
No PyPI access? Using a Dev Container? Inject strata from the published image — no Python install required:
# .devcontainer/Dockerfile
FROM mcr.microsoft.com/devcontainers/base:ubuntu-24.04
COPY --from=ghcr.io/huybrechtsxyz/strata:latest /app/.venv /opt/strata
ENV PATH="/opt/strata/bin:$PATH"
See the Getting Started guide for the full devcontainer and air-gapped registry setup.
Automation & AI Agents
Set STRATA_OUTPUT=json once (or strata config set output json) and every command returns a structured JSON envelope on stdout:
{
"success": true,
"command": "validate",
"execution_id": "fb063135-...",
"timestamp": "2026-05-18T14:31:47.267924",
"data": { "validation_passed": true, "errors": [] },
"messages": [],
"errors": []
}
Key conventions for automation:
| Concern | Guidance |
|---|---|
| Output format | Always use --output json or STRATA_OUTPUT=json |
| Exit codes | 0 success · 1 system failure · 2 bad args · 3 validation failure |
| Workspace | Set STRATA_WORK_PATH to target a workspace without cd |
| Error stream | In console mode, errors go to stderr; structured JSON always goes to stdout |
| Execution correlation | execution_id in the envelope maps directly to strata audit list --execution-id <id> |
| Env-var overrides | Every CLI flag has an XYZ_<OPTION> equivalent (STRATA_VERBOSE=true, STRATA_QUIET=true, …) |
Safe read-only commands that work outside an initialized workspace (INIT_REQUIRED=False): validate, status, schema list, schema get.
License
GNU Affero General Public License v3.0 — see LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for xyz-strata 1.5.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 | |
|---|---|---|---|
| xyz_strata-1.5.0.tar.gz | 934.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| xyz_strata-1.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.2 MB
Release files / xyz_strata-1.5.0.tar.gz
| Download URL | xyz_strata-1.5.0.tar.gz |
|---|---|
| Size | 934.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e75668a87cf1c15844b4bf9b20f420babdbf7b207c424572638d7c31b8f20a89
|
|
BLAKE2b-256 checksum How to use checksums |
edb4b8c7e00ad19dfde8f008d1f2e2f90c56be913c852dc805cb12e6ed480307
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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 / xyz_strata-1.5.0-py3-none-any.whl
| Download URL | xyz_strata-1.5.0-py3-none-any.whl |
|---|---|
| Size | 1.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bf7b73f8115b5765af176a6ba6ec6c765dc20efe2a6b9dc85b5341cb7457a6b0
|
|
BLAKE2b-256 checksum How to use checksums |
ad9dde7f980a116b9198765a659a5bfa30e59be4556e513e36bc04ab645db46b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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}
|
