Skip to main content
Version: Next


1. Install KCL

From the Binary Releases

Each release of KCL includes various OSes and architectures. These binary versions can be manually downloaded and installed from Github and add {install-location}/kclvm/bin to the environment PATH.

MacOS & Linux

export PATH=$PATH:{install-location}/kclvm/bin


$env:PATH += ";{install-location}\kclvm\bin;"

Using script to install the latest release


Install the latest darwin KCL to /usr/local/kclvm/bin

curl -fsSL | /bin/bash


Install the latest linux KCL to /usr/local/kclvm/bin

wget -q -O - | /bin/bash


Install the latest windows KCL to $Env:SystemDrive\kclvm\bin and add this directory to User PATH environment variable.

powershell -Command "iwr -useb | iex"

Homebrew (MacOS)

brew install kcl-lang/tap/kclvm

Scoop (Windows)

Install Scoop first, then add this bucket and install kcl by running:

scoop bucket add kcl-lang
scoop install kcl-lang/kclvm

From Python3

Install kcl through the python3 and pip (python3 requires 3.7.3+).

python3 -m pip install kclvm --user

Add an alias for the kcl command (optional).

alias kcl='python3 -m kclvm'

From Go

Install kcl through the Go command (Go requires 1.17+).

go install

Add an alias for the kcl command (optional).

alias kcl='kcl-go kcl'

From Docker

  • Command
docker run --rm -p 8080:8080 -it kusionstack/kclvm
  • Update image
docker pull kusionstack/kclvm


⚠️ For all the above operating systems and installation methods, if you want to use KCL Python plug-in, you need to ensure that Python 3.7+ is installed and add the python3 command to your PATH environment variable.

To avoid the GLIBC version being too low, for lower versions of Linux such as Centos7, you can visit Github to find the release of kclvm-centos and download and install it.

2. Install the KCL VS Code Extension

To improve the KCL development on VS Code, there are VS Code extensions for both VS Code Web IDE and VS Code.

The VS Code Web IDE can be reached through the browser, and you can search and install the KCL for in the VS Code Extension tab. And here's the syntax highlighting view you'll get:

The KCL extension for the local VS Code IDE provides more rich language support for the KCL language such as highlighting, auto-completion, quick info hover and code navigation, etc. Although the extension is not a must-required part of KCL, it is recommended to install it to improve coding efficiency.

Next step