{"id":18704319,"url":"https://github.com/holos-run/holos","last_synced_at":"2025-04-07T16:19:25.775Z","repository":{"id":252267183,"uuid":"751872684","full_name":"holos-run/holos","owner":"holos-run","description":"Holistic platform manager","archived":false,"fork":false,"pushed_at":"2025-03-05T00:57:45.000Z","size":30346,"stargazers_count":81,"open_issues_count":17,"forks_count":3,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-05T07:03:20.713Z","etag":null,"topics":["configuration","cue","cue-language","devops","gitops","go","kubernetes","platform-engineering"],"latest_commit_sha":null,"homepage":"https://holos.run","language":"CUE","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/holos-run.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-02T14:12:20.000Z","updated_at":"2025-03-04T09:58:46.000Z","dependencies_parsed_at":"2024-08-08T18:48:23.400Z","dependency_job_id":"bc0cb6f6-2b29-4aa1-95b2-e6ea06451917","html_url":"https://github.com/holos-run/holos","commit_stats":null,"previous_names":["holos-run/holos","kube-start/kubestart"],"tags_count":175,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holos-run%2Fholos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holos-run%2Fholos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holos-run%2Fholos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/holos-run%2Fholos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/holos-run","download_url":"https://codeload.github.com/holos-run/holos/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247685634,"owners_count":20979085,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["configuration","cue","cue-language","devops","gitops","go","kubernetes","platform-engineering"],"created_at":"2024-11-07T12:01:05.374Z","updated_at":"2025-04-07T16:19:25.749Z","avatar_url":"https://github.com/holos-run.png","language":"CUE","readme":"# Holos\n\n\u003cimg width=\"50%\"\nalign=\"right\"\nstyle=\"display: block; margin: 40px auto;\"\nsrc=\"https://openinfrastructure.co/blog/2016/02/27/logo/logorectangle.png\"\u003e\n\n[Holos] is a configuration management tool for Kubernetes implementing the\n[rendered manifests pattern]. It handles configurations ranging from single\nresources to multi-cluster platforms across regions.\n\nKey components:\n- Platform schemas defining component integration\n- Building blocks unifying Helm, Kustomize and Kubernetes configs with CUE\n- BuildPlan pipeline for generating, transforming and validating manifests\n\n```mermaid\n---\ntitle: Rendering Overview\n---\ngraph LR\n    Platform[\u003ca href=\"https://holos.run/docs/v1alpha5/api/author/#Platform\"\u003ePlatform\u003c/a\u003e]\n    Component[\u003ca href=\"https://holos.run/docs/v1alpha5/api/author/#ComponentConfig\"\u003eComponents\u003c/a\u003e]\n\n    Helm[\u003ca href=\"https://holos.run/docs/v1alpha5/api/author/#Helm\"\u003eHelm\u003c/a\u003e]\n    Kustomize[\u003ca href=\"https://holos.run/docs/v1alpha5/api/author/#Kustomize\"\u003eKustomize\u003c/a\u003e]\n    Kubernetes[\u003ca href=\"https://holos.run/docs/v1alpha5/api/author/#Kubernetes\"\u003eKubernetes\u003c/a\u003e]\n\n    BuildPlan[\u003ca href=\"https://holos.run/docs/v1alpha5/api/core/#BuildPlan\"\u003eBuildPlan\u003c/a\u003e]\n\n    ResourcesArtifact[\u003ca href=\"https://holos.run/docs/v1alpha5/api/core/#Artifact\"\u003eResources\u003cbr/\u003eArtifact\u003c/a\u003e]\n    GitOpsArtifact[\u003ca href=\"https://holos.run/docs/v1alpha5/api/core/#Artifact\"\u003eGitOps\u003cbr/\u003eArtifact\u003c/a\u003e]\n\n    Generators[\u003ca href=\"https://holos.run/docs/v1alpha5/api/core/#Generator\"\u003eGenerators\u003c/a\u003e]\n    Transformers[\u003ca href=\"https://holos.run/docs/v1alpha5/api/core/#Transformer\"\u003eTransformers\u003c/a\u003e]\n    Validators[\u003ca href=\"https://holos.run/docs/v1alpha5/api/core/#Validator\"\u003eValidators\u003c/a\u003e]\n    Files[Manifest\u003cbr/\u003eFiles]\n\n    Platform --\u003e Component\n    Component --\u003e Helm --\u003e BuildPlan\n    Component --\u003e Kubernetes --\u003e BuildPlan\n    Component --\u003e Kustomize --\u003e BuildPlan\n\n    BuildPlan --\u003e ResourcesArtifact --\u003e Generators\n    BuildPlan --\u003e GitOpsArtifact --\u003e Generators\n\n    Generators --\u003e Transformers --\u003e Validators --\u003e Files\n```\n\n## Setup\n\n```shell\nbrew install holos-run/tap/holos\n```\n\nRefer to [setup] for other installation methods and dependencies.\n\n## Example\n\nSee our [tutorial] for a complete hello world example.\n\n```cue showLineNumbers\npackage holos\n\nholos: Component.BuildPlan\n\nComponent: #Helm \u0026 {\n\tName: \"podinfo\"\n\tChart: {\n\t\tversion: \"6.6.2\"\n\t\trepository: {\n\t\t\tname: \"podinfo\"\n\t\t\turl:  \"https://stefanprodan.github.io/podinfo\"\n\t\t}\n\t}\n\tValues: ui: {\n\t\tmessage: string | *\"Hello World\" @tag(message, type=string)\n\t}\n}\n```\n\n## Organizational Role\n\nPlatform engineers use Holos to generate Kubernetes manifests, both locally and\nin CI pipelines. The manifests are committed to version control and deployed via\nGitOps tools like ArgoCD or Flux.\n\nHolos integrates seamlessly with existing Helm charts, Kustomize bases, and\nother version-controlled configurations.\n\n## Advantages of Holos\n\n### Safe\n\nHolos leverages [CUE] for strong typing and validation of configuration data,\nensuring consistent output from Helm and other tools.\n\n### Consistent\n\nA unified pipeline processes all configurations - whether from CUE, Helm, or\nKustomize - through the same well-defined stages.\n\n### Flexible\n\nComposable building blocks for generation, transformation, validation and\nintegration let teams assemble workflows that match their needs.\n\nThe core is intentionally unopinionated about platform configuration patterns.\nCommon needs like environments and clusters are provided as customizable\n[topics] recipes rather than enforced structures.\n\n## Getting Help\n\nGet support through our [Discord] channel or [GitHub discussions]. Configuration\nchallenges arise at all experience levels - we welcome your questions and are\nhere to help.\n\n## License\n\nHolos is licensed under Apache 2.0 as found in the [LICENSE file](LICENSE).\n\n[Holos]: https://holos.run/docs/overview/\n[rendered manifests pattern]: https://akuity.io/blog/the-rendered-manifests-pattern\n[CUE]: https://cuelang.org/\n[Discord]: https://discord.gg/JgDVbNpye7\n[GitHub discussions]: https://github.com/holos-run/holos/discussions\n[Why CUE for Configuration]: https://holos.run/blog/why-cue-for-configuration/\n[tutorial]: https://holos.run/docs/overview/\n[setup]: https://holos.run/docs/setup/\n[topics]: https://holos.run/docs/topics/\n","funding_links":[],"categories":["CUE","Configuration Management"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fholos-run%2Fholos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fholos-run%2Fholos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fholos-run%2Fholos/lists"}