Koreo – Platform Engineering Toolkit for Kubernetes

TL;DR

TL;DR: Koreo is a meta-controller runtime that lets you compose Kubernetes operators into cohesive internal developer platforms using programmable workflows, structured configuration, and a declarative operator model.

Source and Accuracy Notes

⚠️ This section is MANDATORY. All links must be verified from actual source, not guessed.

• Project page: koreo.dev ← MUST visit and verify
• Source repository: github.com/koreo-dev ← MUST read README
• License: Apache-2.0 ← MUST verify from LICENSE file
• HN launch thread: news.ycombinator.com/item?id=44069854

What Is Koreo?

Koreo is a platform engineering toolkit that introduces a new approach to Kubernetes configuration management and resource orchestration. Built by Real Kinetic, a team with over a decade of platform engineering experience, Koreo positions itself as a meta-controller programming language and runtime.

Rather than replacing tools like Helm, Kustomize, or Crossplane, Koreo composes them. It orchestrates existing Kubernetes controllers into cohesive platforms by mapping outputs of one operator to the inputs of another. The result is a programmable, testable layer on top of your Kubernetes infrastructure.

“It serves as a meta-controller programming language and runtime that allows you to compose off-the-shelf operators into cohesive platforms by orchestrating Kubernetes controllers.”

Core repositories on GitHub:

• koreo-dev/koreo-core — Workflow orchestration engine (~100 stars, Apache-2.0)
• koreo-dev/koreo-controller — Kubernetes controller
• koreo-dev/koreo-helm — Helm chart for controller and UI

Key Features

Programmable Workflows

Koreo workflows define complex, multi-step processes that react to events and manage the lifecycle of Kubernetes resources. Think of it as programming—or choreographing—Kubernetes controllers. Workflows can automate everything from simple deployments to entire cloud environments.

Structured Configuration Management

Configurations are managed as structured data rather than templated strings. This enables validation, transformation, and combination of configurations from multiple sources at scale. You can connect any resource by mapping the outputs of one to the inputs of another.

Dynamic Resource Materialization

Koreo lets you inject values from a config file or overlay partial definitions to build a complete resource view. Combine configurations from different sources—security, compliance, SRE—and apply custom logic to give developers a golden path for provisioning.

Configuration as Functions

Inspired by functional programming, Koreo decomposes configuration into reusable functions. These encapsulate common tasks and logic within workflows, promoting modularity, reducing duplication, and making workflows easier to maintain.

Declarative Operator Model

Define your desired state through workflows and functions; Koreo automatically reconciles actual state to match. This ensures consistency across your infrastructure without manual intervention.

First-Class Testing and Tooling

Koreo includes a built-in testing framework for writing unit tests on individual functions and entire workflows. IDE integration provides real-time feedback, autocomplete, and introspection—making Kubernetes configuration feel like actual programming.

Setup Workflow

Step 1: Install the CLI

The Koreo CLI is available via Homebrew:

brew tap koreo-dev/tap
brew install koreo

Or download pre-built binaries from the GitHub releases page.

Step 2: Initialize a Koreo Project

koreo init my-platform
cd my-platform

This creates a project structure with example workflow and function definitions.

Step 3: Deploy the Controller

koreo deploy

This deploys the Koreo Kubernetes controller to your cluster via the Helm chart.

Step 4: Write Your First Workflow

Define a workflow in a .k.yaml file:

apiVersion: koreo.dev/v1alpha1
kind: Workflow
metadata:
  name: deploy-app
spec:
  steps:
    - name: build
      action: exec
      command: ["kubectl", "apply", "-f", "deployment.yaml"]
    - name: verify
      action: check
      resource: Deployment
      name: my-app
      namespace: default

Apply it with:

koreo apply -f deploy-app.k.yaml

Use Cases

• Internal Developer Platform (IDP) — Build custom IDPs that abstract cloud complexity, enforce governance, and empower developers with self-service capabilities
• Multi-Cloud IaC — Combine ACK, Config Connector, and Azure Service Operator to manage resources across multiple cloud providers through Infrastructure as Code
• Operator Composition — Build custom operators and compose off-the-shelf operators into cohesive platforms
• Deployment Orchestration — Orchestrate canary releases, blue/green deployments, and rollouts with complex dependencies
• Policy as Code — Define and enforce organizational policies declaratively with built-in testing

Compared to Related Tools

Koreo is not a replacement for any single tool—it sits above them. The official docs include comparisons against Helm, Kustomize, Argo Workflows, Crossplane, and kro.

FAQ

Q: Does Koreo replace Helm or Kustomize? A: No. Koreo composes existing tools rather than replacing them. You can use Helm charts and Kustomize overlays within Koreo workflows.

Q: What language are Koreo workflows written in? A: Workflows are defined in YAML with Koreo’s own schema (apiVersion: koreo.dev/v1alpha1). Functions can embed logic in any language that produces JSON output.

Q: Is there a hosted or managed version? A: Yes—Konfigurate is a pre-configured platform powered by Koreo, aimed at startups and scaleups who want a managed IDP without building it themselves.

Q: How does testing work? A: Koreo has a built-in testing framework. You write unit tests in YAML that verify function outputs and workflow behavior before applying to a cluster.

Security Notes

• Koreo runs as a Kubernetes controller in your cluster—review the controller’s RBAC permissions carefully before deployment
• Configuration functions can execute arbitrary commands; treat them with the same care as admission webhooks
• The Helm chart is available at github.com/koreo-dev/koreo-helm for manual inspection before installation

Conclusion

Koreo fills a specific gap in the Kubernetes ecosystem: the inability to compose multiple operators and controllers into a coherent internal platform without writing custom code. By treating workflows as programmable, testable constructs and configurations as structured data, it brings software engineering rigor to platform engineering.

If you are building an IDP or managing complex multi-team Kubernetes environments, Koreo is worth evaluating. The Apache-2.0 license and active development from an experienced platform engineering team make it a credible open-source option in this space.

HN launch thread: news.ycombinator.com/item?id=44069854