<!-- Copyright 2018 The CUE Authors Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. -->

CUE - Configure, Unify, Execute

CUE makes it easy to validate data, write schemas, and ensure configurations align with policies.

CUE works with a wide range of tools and formats that you're already using such as Go, JSON, YAML, TOML, XML, OpenAPI, Protobuf, and JSON Schema.

For more information and documentation, including tutorials and guides, see cuelang.org.

Download and Install

The full range of installation methods for the cue command are listed on cuelang.org, including the official container image suitable for use with Docker.

Release builds

Download the latest release from GitHub.

Install from Source

You need Go 1.25 or later to install CUE from source:

go install cuelang.org/go/cmd/cue@latest

You can also git clone the repository and build it directly via go install ./cmd/cue.

Built cue binaries include version information as reported by cue version, which go build derives from the VCS. We recommend that downstream packagers build releases from git tags rather than source archives to ensure this works.

Learning CUE

The fastest way to learn the basics is to follow the language tour on the website.

The cuelang.org website also contains more documentation, including tutorials, how-to guides, concept guides, and references.

Popular references

• The official CUE Language Specification
• The CUE Go API on pkg.go.dev
• Builtin packages and functions available from CUE programs
• The cue command, a versatile interface for working with data, CUE, and its ecosystem

Go release support policy

As a general rule, we support the two most recent major releases of Go, matching Go's security policy. For example, if CUE v0.7.0 is released when Go's latest version is 1.21.5, v0.7.x including any following bugfix releases will require Go 1.20 or later.

Code of Conduct

Guidelines for participating in CUE community spaces and a reporting process for handling issues can be found in the Code of Conduct.

Contact

• Ask questions via GitHub Discussions
• Chat with us on Slack and Discord
• Subscribe to our Community Calendar for community updates, demos, office hours, etc