Releases: runtimeverification/k
K Framework Release 5.3.62
Installing the K Framework Package
We currently strive to provide packages for the following platforms:
- Ubuntu Focal Fossa (20.04) and Jammy Jellyfish (22.04)
- Debian Bullseye
- Arch Linux
- MacOS X Mojave/Homewbrew
- Docker Images
Pre-installation Notes
-
We do not currently support running K natively on Windows. To use K on
Windows 10, you are encouraged to install the
Windows Subsystem for Linux (version 2)
and follow the instructions for installing Ubuntu Focal.If you have already installed WSL, before proceeding, you will need to
enter the WSL environment. You can do this by:- opening up the command prompt (accessible by searching
cmd
or
command prompt
from the start menu); - using the
wsl.exe
command to access the WSL environment.
- opening up the command prompt (accessible by searching
-
To use K in other non-linux environments (e.g. Windows 8 or earlier),
you will need to use a virtual machine (VM) software. We assume you have:- Created a virtual machine
- Installed a Linux distribution (e.g. Ubuntu Focal Fossa) on your
virtual machine
Consult your virtual machine software if you need help with the above
steps. We recommend the free VirtualBox virtual machine software.Before proceeding, follow the virtual machine softare UI to start your
Linux virtual machine and enter the command line environment. -
WSL and virtual machine users should be aware that, if you use your web
browser to download the package, you will need to make it accessible to
the command line environment. For this reason, we recommend downloading the
package from the command line directly using a tool likewget
. For
example, you could copy the package download URL and then type:wget <package-download-url>
where
<package-download-url>
is replaced by the URL you just copied. -
K depends on version 4.8.15 of Z3, which may not be supplied by package
managers. If this is the case, it should be built and installed from source
following the
instructions in
the Z3 repository. Other versions (older and newer) are not supported by K,
and may lead to incorrect behaviour or performance issues.
Downloading Packages
Download the appropriate package from the GitHub, via the
Releases page.
Releases are generated as often as possible from master
build.
Installing Packages
For version X.Y.Z
, disto DISTRO
, and package ID ID
, the following
instructions tell you how to install on each system. Note that this typically
requires about ~1.4GB of dependencies and will take some time.
- On Linux systems, K will typically be installed under
/usr
. - On macOS/brew, K will typically be installed under
/usr/local
.
Ubuntu Focal (20.04)
sudo apt install ./kframework_X.Y.Z_amd64_focal.deb
Ubuntu Jammy (22.04)
sudo apt install ./kframework_X.Y.Z_amd64_jammy.deb
Debian Bullseye
sudo apt install ./kframework_X.Y.Z_amd64_bullseye.deb
Arch Linux
pacman -U ./kframework-git-X.Y.Z-1-x86_64.pkg.tar.zst
MacOS X Mojave/Homebrew
Homebrew (or just brew) is a third-party package manager
for MacOS.
If you have not installed brew, you must do so before installing the K
Framework brew package.
With brew installed, do the following to install the K Framework brew package
(with build number BN
):
brew install kframework--X.Y.Z.ID.bottle.BN.tar.gz -v
Note: we do not yet have a MacOS Monterey bottle. The existing brew package
also does not work on M1 Silicon Macs. If you have either of these systems,
you should build from source for the time being.
Homebrew Alternate Installation
To directly install the latest K Framework brew package without needing to
download it separately, do the following:
brew install kframework/k/kframework
Or, to streamline future K Framework upgrades, you can tap
the K Framework
package repository. This lets future installations/upgrades/etc... use the
unprefixed package name.
brew tap kframework/k
brew install kframework
Docker Images
Docker images with K pre-installed are available at the
runtimeverification/kframework-k Docker Hub repository.
Each release at COMMIT_ID
has an image associated with it at
runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
.
The latest master
build Docker image can be accessed with COMMIT_ID
set to
master
.
To run the image directly:
docker run -it runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
and to make a Docker Image based on it, use the following line in your
Dockerfile
:
FROM runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
We also create Ubuntu 22.04 images with the ubuntu-jammy-COMMIT_ID
tags.
Testing Packages
The easiest way to test the K package is to copy a K tutorial language and
check if you can compile and run an included example.
-
Start by copying the K tutorial to some work directory
(e.g.$HOME/pl-tutorial
) from the K distribution root. Using a Linux
package, this command typically will be like:$ cp -R /usr/share/kframework/pl-tutorial $HOME/pl-tutorial
On macOS/brew, this command typically will be like:
$ cp -R /usr/local/share/kframework/pl-tutorial $HOME/pl-tutorial
This step is needed because sometimes only the
root
user can run the
examples in the default installation directory. -
Now you can try to run some programs:
$ cd $HOME/pl-tutorial/2_languages/1_simple/1_untyped $ make kompile $ krun tests/diverse/factorial.simple
K Framework Release 5.3.61
Installing the K Framework Package
We currently strive to provide packages for the following platforms:
- Ubuntu Focal Fossa (20.04) and Jammy Jellyfish (22.04)
- Debian Bullseye
- Arch Linux
- MacOS X Mojave/Homewbrew
- Docker Images
Pre-installation Notes
-
We do not currently support running K natively on Windows. To use K on
Windows 10, you are encouraged to install the
Windows Subsystem for Linux (version 2)
and follow the instructions for installing Ubuntu Focal.If you have already installed WSL, before proceeding, you will need to
enter the WSL environment. You can do this by:- opening up the command prompt (accessible by searching
cmd
or
command prompt
from the start menu); - using the
wsl.exe
command to access the WSL environment.
- opening up the command prompt (accessible by searching
-
To use K in other non-linux environments (e.g. Windows 8 or earlier),
you will need to use a virtual machine (VM) software. We assume you have:- Created a virtual machine
- Installed a Linux distribution (e.g. Ubuntu Focal Fossa) on your
virtual machine
Consult your virtual machine software if you need help with the above
steps. We recommend the free VirtualBox virtual machine software.Before proceeding, follow the virtual machine softare UI to start your
Linux virtual machine and enter the command line environment. -
WSL and virtual machine users should be aware that, if you use your web
browser to download the package, you will need to make it accessible to
the command line environment. For this reason, we recommend downloading the
package from the command line directly using a tool likewget
. For
example, you could copy the package download URL and then type:wget <package-download-url>
where
<package-download-url>
is replaced by the URL you just copied. -
K depends on version 4.8.15 of Z3, which may not be supplied by package
managers. If this is the case, it should be built and installed from source
following the
instructions in
the Z3 repository. Other versions (older and newer) are not supported by K,
and may lead to incorrect behaviour or performance issues.
Downloading Packages
Download the appropriate package from the GitHub, via the
Releases page.
Releases are generated as often as possible from master
build.
Installing Packages
For version X.Y.Z
, disto DISTRO
, and package ID ID
, the following
instructions tell you how to install on each system. Note that this typically
requires about ~1.4GB of dependencies and will take some time.
- On Linux systems, K will typically be installed under
/usr
. - On macOS/brew, K will typically be installed under
/usr/local
.
Ubuntu Focal (20.04)
sudo apt install ./kframework_X.Y.Z_amd64_focal.deb
Ubuntu Jammy (22.04)
sudo apt install ./kframework_X.Y.Z_amd64_jammy.deb
Debian Bullseye
sudo apt install ./kframework_X.Y.Z_amd64_bullseye.deb
Arch Linux
pacman -U ./kframework-git-X.Y.Z-1-x86_64.pkg.tar.zst
MacOS X Mojave/Homebrew
Homebrew (or just brew) is a third-party package manager
for MacOS.
If you have not installed brew, you must do so before installing the K
Framework brew package.
With brew installed, do the following to install the K Framework brew package
(with build number BN
):
brew install kframework--X.Y.Z.ID.bottle.BN.tar.gz -v
Note: we do not yet have a MacOS Monterey bottle. The existing brew package
also does not work on M1 Silicon Macs. If you have either of these systems,
you should build from source for the time being.
Homebrew Alternate Installation
To directly install the latest K Framework brew package without needing to
download it separately, do the following:
brew install kframework/k/kframework
Or, to streamline future K Framework upgrades, you can tap
the K Framework
package repository. This lets future installations/upgrades/etc... use the
unprefixed package name.
brew tap kframework/k
brew install kframework
Docker Images
Docker images with K pre-installed are available at the
runtimeverification/kframework-k Docker Hub repository.
Each release at COMMIT_ID
has an image associated with it at
runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
.
The latest master
build Docker image can be accessed with COMMIT_ID
set to
master
.
To run the image directly:
docker run -it runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
and to make a Docker Image based on it, use the following line in your
Dockerfile
:
FROM runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
We also create Ubuntu 22.04 images with the ubuntu-jammy-COMMIT_ID
tags.
Testing Packages
The easiest way to test the K package is to copy a K tutorial language and
check if you can compile and run an included example.
-
Start by copying the K tutorial to some work directory
(e.g.$HOME/pl-tutorial
) from the K distribution root. Using a Linux
package, this command typically will be like:$ cp -R /usr/share/kframework/pl-tutorial $HOME/pl-tutorial
On macOS/brew, this command typically will be like:
$ cp -R /usr/local/share/kframework/pl-tutorial $HOME/pl-tutorial
This step is needed because sometimes only the
root
user can run the
examples in the default installation directory. -
Now you can try to run some programs:
$ cd $HOME/pl-tutorial/2_languages/1_simple/1_untyped $ make kompile $ krun tests/diverse/factorial.simple
K Framework Release 5.3.60
Installing the K Framework Package
We currently strive to provide packages for the following platforms:
- Ubuntu Focal Fossa (20.04) and Jammy Jellyfish (22.04)
- Debian Bullseye
- Arch Linux
- MacOS X Mojave/Homewbrew
- Docker Images
Pre-installation Notes
-
We do not currently support running K natively on Windows. To use K on
Windows 10, you are encouraged to install the
Windows Subsystem for Linux (version 2)
and follow the instructions for installing Ubuntu Focal.If you have already installed WSL, before proceeding, you will need to
enter the WSL environment. You can do this by:- opening up the command prompt (accessible by searching
cmd
or
command prompt
from the start menu); - using the
wsl.exe
command to access the WSL environment.
- opening up the command prompt (accessible by searching
-
To use K in other non-linux environments (e.g. Windows 8 or earlier),
you will need to use a virtual machine (VM) software. We assume you have:- Created a virtual machine
- Installed a Linux distribution (e.g. Ubuntu Focal Fossa) on your
virtual machine
Consult your virtual machine software if you need help with the above
steps. We recommend the free VirtualBox virtual machine software.Before proceeding, follow the virtual machine softare UI to start your
Linux virtual machine and enter the command line environment. -
WSL and virtual machine users should be aware that, if you use your web
browser to download the package, you will need to make it accessible to
the command line environment. For this reason, we recommend downloading the
package from the command line directly using a tool likewget
. For
example, you could copy the package download URL and then type:wget <package-download-url>
where
<package-download-url>
is replaced by the URL you just copied. -
K depends on version 4.8.15 of Z3, which may not be supplied by package
managers. If this is the case, it should be built and installed from source
following the
instructions in
the Z3 repository. Other versions (older and newer) are not supported by K,
and may lead to incorrect behaviour or performance issues.
Downloading Packages
Download the appropriate package from the GitHub, via the
Releases page.
Releases are generated as often as possible from master
build.
Installing Packages
For version X.Y.Z
, disto DISTRO
, and package ID ID
, the following
instructions tell you how to install on each system. Note that this typically
requires about ~1.4GB of dependencies and will take some time.
- On Linux systems, K will typically be installed under
/usr
. - On macOS/brew, K will typically be installed under
/usr/local
.
Ubuntu Focal (20.04)
sudo apt install ./kframework_X.Y.Z_amd64_focal.deb
Ubuntu Jammy (22.04)
sudo apt install ./kframework_X.Y.Z_amd64_jammy.deb
Debian Bullseye
sudo apt install ./kframework_X.Y.Z_amd64_bullseye.deb
Arch Linux
pacman -U ./kframework-git-X.Y.Z-1-x86_64.pkg.tar.zst
MacOS X Mojave/Homebrew
Homebrew (or just brew) is a third-party package manager
for MacOS.
If you have not installed brew, you must do so before installing the K
Framework brew package.
With brew installed, do the following to install the K Framework brew package
(with build number BN
):
brew install kframework--X.Y.Z.ID.bottle.BN.tar.gz -v
Note: we do not yet have a MacOS Monterey bottle. The existing brew package
also does not work on M1 Silicon Macs. If you have either of these systems,
you should build from source for the time being.
Homebrew Alternate Installation
To directly install the latest K Framework brew package without needing to
download it separately, do the following:
brew install kframework/k/kframework
Or, to streamline future K Framework upgrades, you can tap
the K Framework
package repository. This lets future installations/upgrades/etc... use the
unprefixed package name.
brew tap kframework/k
brew install kframework
Docker Images
Docker images with K pre-installed are available at the
runtimeverification/kframework-k Docker Hub repository.
Each release at COMMIT_ID
has an image associated with it at
runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
.
The latest master
build Docker image can be accessed with COMMIT_ID
set to
master
.
To run the image directly:
docker run -it runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
and to make a Docker Image based on it, use the following line in your
Dockerfile
:
FROM runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
We also create Ubuntu 22.04 images with the ubuntu-jammy-COMMIT_ID
tags.
Testing Packages
The easiest way to test the K package is to copy a K tutorial language and
check if you can compile and run an included example.
-
Start by copying the K tutorial to some work directory
(e.g.$HOME/pl-tutorial
) from the K distribution root. Using a Linux
package, this command typically will be like:$ cp -R /usr/share/kframework/pl-tutorial $HOME/pl-tutorial
On macOS/brew, this command typically will be like:
$ cp -R /usr/local/share/kframework/pl-tutorial $HOME/pl-tutorial
This step is needed because sometimes only the
root
user can run the
examples in the default installation directory. -
Now you can try to run some programs:
$ cd $HOME/pl-tutorial/2_languages/1_simple/1_untyped $ make kompile $ krun tests/diverse/factorial.simple
K Framework Release 5.3.58
Installing the K Framework Package
We currently strive to provide packages for the following platforms:
- Ubuntu Focal Fossa (20.04) and Jammy Jellyfish (22.04)
- Debian Bullseye
- Arch Linux
- MacOS X Mojave/Homewbrew
- Docker Images
Pre-installation Notes
-
We do not currently support running K natively on Windows. To use K on
Windows 10, you are encouraged to install the
Windows Subsystem for Linux (version 2)
and follow the instructions for installing Ubuntu Focal.If you have already installed WSL, before proceeding, you will need to
enter the WSL environment. You can do this by:- opening up the command prompt (accessible by searching
cmd
or
command prompt
from the start menu); - using the
wsl.exe
command to access the WSL environment.
- opening up the command prompt (accessible by searching
-
To use K in other non-linux environments (e.g. Windows 8 or earlier),
you will need to use a virtual machine (VM) software. We assume you have:- Created a virtual machine
- Installed a Linux distribution (e.g. Ubuntu Focal Fossa) on your
virtual machine
Consult your virtual machine software if you need help with the above
steps. We recommend the free VirtualBox virtual machine software.Before proceeding, follow the virtual machine softare UI to start your
Linux virtual machine and enter the command line environment. -
WSL and virtual machine users should be aware that, if you use your web
browser to download the package, you will need to make it accessible to
the command line environment. For this reason, we recommend downloading the
package from the command line directly using a tool likewget
. For
example, you could copy the package download URL and then type:wget <package-download-url>
where
<package-download-url>
is replaced by the URL you just copied. -
K depends on version 4.8.15 of Z3, which may not be supplied by package
managers. If this is the case, it should be built and installed from source
following the
instructions in
the Z3 repository. Other versions (older and newer) are not supported by K,
and may lead to incorrect behaviour or performance issues.
Downloading Packages
Download the appropriate package from the GitHub, via the
Releases page.
Releases are generated as often as possible from master
build.
Installing Packages
For version X.Y.Z
, disto DISTRO
, and package ID ID
, the following
instructions tell you how to install on each system. Note that this typically
requires about ~1.4GB of dependencies and will take some time.
- On Linux systems, K will typically be installed under
/usr
. - On macOS/brew, K will typically be installed under
/usr/local
.
Ubuntu Focal (20.04)
sudo apt install ./kframework_X.Y.Z_amd64_focal.deb
Ubuntu Jammy (22.04)
sudo apt install ./kframework_X.Y.Z_amd64_jammy.deb
Debian Bullseye
sudo apt install ./kframework_X.Y.Z_amd64_bullseye.deb
Arch Linux
pacman -U ./kframework-git-X.Y.Z-1-x86_64.pkg.tar.zst
MacOS X Mojave/Homebrew
Homebrew (or just brew) is a third-party package manager
for MacOS.
If you have not installed brew, you must do so before installing the K
Framework brew package.
With brew installed, do the following to install the K Framework brew package
(with build number BN
):
brew install kframework--X.Y.Z.ID.bottle.BN.tar.gz -v
Note: we do not yet have a MacOS Monterey bottle. The existing brew package
also does not work on M1 Silicon Macs. If you have either of these systems,
you should build from source for the time being.
Homebrew Alternate Installation
To directly install the latest K Framework brew package without needing to
download it separately, do the following:
brew install kframework/k/kframework
Or, to streamline future K Framework upgrades, you can tap
the K Framework
package repository. This lets future installations/upgrades/etc... use the
unprefixed package name.
brew tap kframework/k
brew install kframework
Docker Images
Docker images with K pre-installed are available at the
runtimeverification/kframework-k Docker Hub repository.
Each release at COMMIT_ID
has an image associated with it at
runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
.
The latest master
build Docker image can be accessed with COMMIT_ID
set to
master
.
To run the image directly:
docker run -it runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
and to make a Docker Image based on it, use the following line in your
Dockerfile
:
FROM runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
We also create Ubuntu 22.04 images with the ubuntu-jammy-COMMIT_ID
tags.
Testing Packages
The easiest way to test the K package is to copy a K tutorial language and
check if you can compile and run an included example.
-
Start by copying the K tutorial to some work directory
(e.g.$HOME/pl-tutorial
) from the K distribution root. Using a Linux
package, this command typically will be like:$ cp -R /usr/share/kframework/pl-tutorial $HOME/pl-tutorial
On macOS/brew, this command typically will be like:
$ cp -R /usr/local/share/kframework/pl-tutorial $HOME/pl-tutorial
This step is needed because sometimes only the
root
user can run the
examples in the default installation directory. -
Now you can try to run some programs:
$ cd $HOME/pl-tutorial/2_languages/1_simple/1_untyped $ make kompile $ krun tests/diverse/factorial.simple
K Framework Release 5.3.57
Installing the K Framework Package
We currently strive to provide packages for the following platforms:
- Ubuntu Focal Fossa (20.04) and Jammy Jellyfish (22.04)
- Debian Bullseye
- Arch Linux
- MacOS X Mojave/Homewbrew
- Docker Images
Pre-installation Notes
-
We do not currently support running K natively on Windows. To use K on
Windows 10, you are encouraged to install the
Windows Subsystem for Linux (version 2)
and follow the instructions for installing Ubuntu Focal.If you have already installed WSL, before proceeding, you will need to
enter the WSL environment. You can do this by:- opening up the command prompt (accessible by searching
cmd
or
command prompt
from the start menu); - using the
wsl.exe
command to access the WSL environment.
- opening up the command prompt (accessible by searching
-
To use K in other non-linux environments (e.g. Windows 8 or earlier),
you will need to use a virtual machine (VM) software. We assume you have:- Created a virtual machine
- Installed a Linux distribution (e.g. Ubuntu Focal Fossa) on your
virtual machine
Consult your virtual machine software if you need help with the above
steps. We recommend the free VirtualBox virtual machine software.Before proceeding, follow the virtual machine softare UI to start your
Linux virtual machine and enter the command line environment. -
WSL and virtual machine users should be aware that, if you use your web
browser to download the package, you will need to make it accessible to
the command line environment. For this reason, we recommend downloading the
package from the command line directly using a tool likewget
. For
example, you could copy the package download URL and then type:wget <package-download-url>
where
<package-download-url>
is replaced by the URL you just copied. -
K depends on version 4.8.15 of Z3, which may not be supplied by package
managers. If this is the case, it should be built and installed from source
following the
instructions in
the Z3 repository. Other versions (older and newer) are not supported by K,
and may lead to incorrect behaviour or performance issues.
Downloading Packages
Download the appropriate package from the GitHub, via the
Releases page.
Releases are generated as often as possible from master
build.
Installing Packages
For version X.Y.Z
, disto DISTRO
, and package ID ID
, the following
instructions tell you how to install on each system. Note that this typically
requires about ~1.4GB of dependencies and will take some time.
- On Linux systems, K will typically be installed under
/usr
. - On macOS/brew, K will typically be installed under
/usr/local
.
Ubuntu Focal (20.04)
sudo apt install ./kframework_X.Y.Z_amd64_focal.deb
Ubuntu Jammy (22.04)
sudo apt install ./kframework_X.Y.Z_amd64_jammy.deb
Debian Bullseye
sudo apt install ./kframework_X.Y.Z_amd64_bullseye.deb
Arch Linux
pacman -U ./kframework-git-X.Y.Z-1-x86_64.pkg.tar.zst
MacOS X Mojave/Homebrew
Homebrew (or just brew) is a third-party package manager
for MacOS.
If you have not installed brew, you must do so before installing the K
Framework brew package.
With brew installed, do the following to install the K Framework brew package
(with build number BN
):
brew install kframework--X.Y.Z.ID.bottle.BN.tar.gz -v
Note: we do not yet have a MacOS Monterey bottle. The existing brew package
also does not work on M1 Silicon Macs. If you have either of these systems,
you should build from source for the time being.
Homebrew Alternate Installation
To directly install the latest K Framework brew package without needing to
download it separately, do the following:
brew install kframework/k/kframework
Or, to streamline future K Framework upgrades, you can tap
the K Framework
package repository. This lets future installations/upgrades/etc... use the
unprefixed package name.
brew tap kframework/k
brew install kframework
Docker Images
Docker images with K pre-installed are available at the
runtimeverification/kframework-k Docker Hub repository.
Each release at COMMIT_ID
has an image associated with it at
runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
.
The latest master
build Docker image can be accessed with COMMIT_ID
set to
master
.
To run the image directly:
docker run -it runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
and to make a Docker Image based on it, use the following line in your
Dockerfile
:
FROM runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
We also create Ubuntu 22.04 images with the ubuntu-jammy-COMMIT_ID
tags.
Testing Packages
The easiest way to test the K package is to copy a K tutorial language and
check if you can compile and run an included example.
-
Start by copying the K tutorial to some work directory
(e.g.$HOME/pl-tutorial
) from the K distribution root. Using a Linux
package, this command typically will be like:$ cp -R /usr/share/kframework/pl-tutorial $HOME/pl-tutorial
On macOS/brew, this command typically will be like:
$ cp -R /usr/local/share/kframework/pl-tutorial $HOME/pl-tutorial
This step is needed because sometimes only the
root
user can run the
examples in the default installation directory. -
Now you can try to run some programs:
$ cd $HOME/pl-tutorial/2_languages/1_simple/1_untyped $ make kompile $ krun tests/diverse/factorial.simple
K Framework Release 5.3.56
Installing the K Framework Package
We currently strive to provide packages for the following platforms:
- Ubuntu Focal Fossa (20.04) and Jammy Jellyfish (22.04)
- Debian Bullseye
- Arch Linux
- MacOS X Mojave/Homewbrew
- Docker Images
Pre-installation Notes
-
We do not currently support running K natively on Windows. To use K on
Windows 10, you are encouraged to install the
Windows Subsystem for Linux (version 2)
and follow the instructions for installing Ubuntu Focal.If you have already installed WSL, before proceeding, you will need to
enter the WSL environment. You can do this by:- opening up the command prompt (accessible by searching
cmd
or
command prompt
from the start menu); - using the
wsl.exe
command to access the WSL environment.
- opening up the command prompt (accessible by searching
-
To use K in other non-linux environments (e.g. Windows 8 or earlier),
you will need to use a virtual machine (VM) software. We assume you have:- Created a virtual machine
- Installed a Linux distribution (e.g. Ubuntu Focal Fossa) on your
virtual machine
Consult your virtual machine software if you need help with the above
steps. We recommend the free VirtualBox virtual machine software.Before proceeding, follow the virtual machine softare UI to start your
Linux virtual machine and enter the command line environment. -
WSL and virtual machine users should be aware that, if you use your web
browser to download the package, you will need to make it accessible to
the command line environment. For this reason, we recommend downloading the
package from the command line directly using a tool likewget
. For
example, you could copy the package download URL and then type:wget <package-download-url>
where
<package-download-url>
is replaced by the URL you just copied. -
K depends on version 4.8.15 of Z3, which may not be supplied by package
managers. If this is the case, it should be built and installed from source
following the
instructions in
the Z3 repository. Other versions (older and newer) are not supported by K,
and may lead to incorrect behaviour or performance issues.
Downloading Packages
Download the appropriate package from the GitHub, via the
Releases page.
Releases are generated as often as possible from master
build.
Installing Packages
For version X.Y.Z
, disto DISTRO
, and package ID ID
, the following
instructions tell you how to install on each system. Note that this typically
requires about ~1.4GB of dependencies and will take some time.
- On Linux systems, K will typically be installed under
/usr
. - On macOS/brew, K will typically be installed under
/usr/local
.
Ubuntu Focal (20.04)
sudo apt install ./kframework_X.Y.Z_amd64_focal.deb
Ubuntu Jammy (22.04)
sudo apt install ./kframework_X.Y.Z_amd64_jammy.deb
Debian Bullseye
sudo apt install ./kframework_X.Y.Z_amd64_bullseye.deb
Arch Linux
pacman -U ./kframework-git-X.Y.Z-1-x86_64.pkg.tar.zst
MacOS X Mojave/Homebrew
Homebrew (or just brew) is a third-party package manager
for MacOS.
If you have not installed brew, you must do so before installing the K
Framework brew package.
With brew installed, do the following to install the K Framework brew package
(with build number BN
):
brew install kframework--X.Y.Z.ID.bottle.BN.tar.gz -v
Note: we do not yet have a MacOS Monterey bottle. The existing brew package
also does not work on M1 Silicon Macs. If you have either of these systems,
you should build from source for the time being.
Homebrew Alternate Installation
To directly install the latest K Framework brew package without needing to
download it separately, do the following:
brew install kframework/k/kframework
Or, to streamline future K Framework upgrades, you can tap
the K Framework
package repository. This lets future installations/upgrades/etc... use the
unprefixed package name.
brew tap kframework/k
brew install kframework
Docker Images
Docker images with K pre-installed are available at the
runtimeverification/kframework-k Docker Hub repository.
Each release at COMMIT_ID
has an image associated with it at
runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
.
The latest master
build Docker image can be accessed with COMMIT_ID
set to
master
.
To run the image directly:
docker run -it runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
and to make a Docker Image based on it, use the following line in your
Dockerfile
:
FROM runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
We also create Ubuntu 22.04 images with the ubuntu-jammy-COMMIT_ID
tags.
Testing Packages
The easiest way to test the K package is to copy a K tutorial language and
check if you can compile and run an included example.
-
Start by copying the K tutorial to some work directory
(e.g.$HOME/pl-tutorial
) from the K distribution root. Using a Linux
package, this command typically will be like:$ cp -R /usr/share/kframework/pl-tutorial $HOME/pl-tutorial
On macOS/brew, this command typically will be like:
$ cp -R /usr/local/share/kframework/pl-tutorial $HOME/pl-tutorial
This step is needed because sometimes only the
root
user can run the
examples in the default installation directory. -
Now you can try to run some programs:
$ cd $HOME/pl-tutorial/2_languages/1_simple/1_untyped $ make kompile $ krun tests/diverse/factorial.simple
K Framework Release 5.3.55
Installing the K Framework Package
We currently strive to provide packages for the following platforms:
- Ubuntu Focal Fossa (20.04) and Jammy Jellyfish (22.04)
- Debian Bullseye
- Arch Linux
- MacOS X Mojave/Homewbrew
- Docker Images
Pre-installation Notes
-
We do not currently support running K natively on Windows. To use K on
Windows 10, you are encouraged to install the
Windows Subsystem for Linux (version 2)
and follow the instructions for installing Ubuntu Focal.If you have already installed WSL, before proceeding, you will need to
enter the WSL environment. You can do this by:- opening up the command prompt (accessible by searching
cmd
or
command prompt
from the start menu); - using the
wsl.exe
command to access the WSL environment.
- opening up the command prompt (accessible by searching
-
To use K in other non-linux environments (e.g. Windows 8 or earlier),
you will need to use a virtual machine (VM) software. We assume you have:- Created a virtual machine
- Installed a Linux distribution (e.g. Ubuntu Focal Fossa) on your
virtual machine
Consult your virtual machine software if you need help with the above
steps. We recommend the free VirtualBox virtual machine software.Before proceeding, follow the virtual machine softare UI to start your
Linux virtual machine and enter the command line environment. -
WSL and virtual machine users should be aware that, if you use your web
browser to download the package, you will need to make it accessible to
the command line environment. For this reason, we recommend downloading the
package from the command line directly using a tool likewget
. For
example, you could copy the package download URL and then type:wget <package-download-url>
where
<package-download-url>
is replaced by the URL you just copied. -
K depends on version 4.8.15 of Z3, which may not be supplied by package
managers. If this is the case, it should be built and installed from source
following the
instructions in
the Z3 repository. Other versions (older and newer) are not supported by K,
and may lead to incorrect behaviour or performance issues.
Downloading Packages
Download the appropriate package from the GitHub, via the
Releases page.
Releases are generated as often as possible from master
build.
Installing Packages
For version X.Y.Z
, disto DISTRO
, and package ID ID
, the following
instructions tell you how to install on each system. Note that this typically
requires about ~1.4GB of dependencies and will take some time.
- On Linux systems, K will typically be installed under
/usr
. - On macOS/brew, K will typically be installed under
/usr/local
.
Ubuntu Focal (20.04)
sudo apt install ./kframework_X.Y.Z_amd64_focal.deb
Ubuntu Jammy (22.04)
sudo apt install ./kframework_X.Y.Z_amd64_jammy.deb
Debian Bullseye
sudo apt install ./kframework_X.Y.Z_amd64_bullseye.deb
Arch Linux
pacman -U ./kframework-git-X.Y.Z-1-x86_64.pkg.tar.zst
MacOS X Mojave/Homebrew
Homebrew (or just brew) is a third-party package manager
for MacOS.
If you have not installed brew, you must do so before installing the K
Framework brew package.
With brew installed, do the following to install the K Framework brew package
(with build number BN
):
brew install kframework--X.Y.Z.ID.bottle.BN.tar.gz -v
Note: we do not yet have a MacOS Monterey bottle. The existing brew package
also does not work on M1 Silicon Macs. If you have either of these systems,
you should build from source for the time being.
Homebrew Alternate Installation
To directly install the latest K Framework brew package without needing to
download it separately, do the following:
brew install kframework/k/kframework
Or, to streamline future K Framework upgrades, you can tap
the K Framework
package repository. This lets future installations/upgrades/etc... use the
unprefixed package name.
brew tap kframework/k
brew install kframework
Docker Images
Docker images with K pre-installed are available at the
runtimeverification/kframework-k Docker Hub repository.
Each release at COMMIT_ID
has an image associated with it at
runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
.
The latest master
build Docker image can be accessed with COMMIT_ID
set to
master
.
To run the image directly:
docker run -it runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
and to make a Docker Image based on it, use the following line in your
Dockerfile
:
FROM runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
We also create Ubuntu 22.04 images with the ubuntu-jammy-COMMIT_ID
tags.
Testing Packages
The easiest way to test the K package is to copy a K tutorial language and
check if you can compile and run an included example.
-
Start by copying the K tutorial to some work directory
(e.g.$HOME/pl-tutorial
) from the K distribution root. Using a Linux
package, this command typically will be like:$ cp -R /usr/share/kframework/pl-tutorial $HOME/pl-tutorial
On macOS/brew, this command typically will be like:
$ cp -R /usr/local/share/kframework/pl-tutorial $HOME/pl-tutorial
This step is needed because sometimes only the
root
user can run the
examples in the default installation directory. -
Now you can try to run some programs:
$ cd $HOME/pl-tutorial/2_languages/1_simple/1_untyped $ make kompile $ krun tests/diverse/factorial.simple
K Framework Release 5.3.54
Installing the K Framework Package
We currently strive to provide packages for the following platforms:
- Ubuntu Focal Fossa (20.04) and Jammy Jellyfish (22.04)
- Debian Bullseye
- Arch Linux
- MacOS X Mojave/Homewbrew
- Docker Images
Pre-installation Notes
-
We do not currently support running K natively on Windows. To use K on
Windows 10, you are encouraged to install the
Windows Subsystem for Linux (version 2)
and follow the instructions for installing Ubuntu Focal.If you have already installed WSL, before proceeding, you will need to
enter the WSL environment. You can do this by:- opening up the command prompt (accessible by searching
cmd
or
command prompt
from the start menu); - using the
wsl.exe
command to access the WSL environment.
- opening up the command prompt (accessible by searching
-
To use K in other non-linux environments (e.g. Windows 8 or earlier),
you will need to use a virtual machine (VM) software. We assume you have:- Created a virtual machine
- Installed a Linux distribution (e.g. Ubuntu Focal Fossa) on your
virtual machine
Consult your virtual machine software if you need help with the above
steps. We recommend the free VirtualBox virtual machine software.Before proceeding, follow the virtual machine softare UI to start your
Linux virtual machine and enter the command line environment. -
WSL and virtual machine users should be aware that, if you use your web
browser to download the package, you will need to make it accessible to
the command line environment. For this reason, we recommend downloading the
package from the command line directly using a tool likewget
. For
example, you could copy the package download URL and then type:wget <package-download-url>
where
<package-download-url>
is replaced by the URL you just copied. -
K depends on version 4.8.15 of Z3, which may not be supplied by package
managers. If this is the case, it should be built and installed from source
following the
instructions in
the Z3 repository. Other versions (older and newer) are not supported by K,
and may lead to incorrect behaviour or performance issues.
Downloading Packages
Download the appropriate package from the GitHub, via the
Releases page.
Releases are generated as often as possible from master
build.
Installing Packages
For version X.Y.Z
, disto DISTRO
, and package ID ID
, the following
instructions tell you how to install on each system. Note that this typically
requires about ~1.4GB of dependencies and will take some time.
- On Linux systems, K will typically be installed under
/usr
. - On macOS/brew, K will typically be installed under
/usr/local
.
Ubuntu Focal (20.04)
sudo apt install ./kframework_X.Y.Z_amd64_focal.deb
Ubuntu Jammy (22.04)
sudo apt install ./kframework_X.Y.Z_amd64_jammy.deb
Debian Bullseye
sudo apt install ./kframework_X.Y.Z_amd64_bullseye.deb
Arch Linux
pacman -U ./kframework-git-X.Y.Z-1-x86_64.pkg.tar.zst
MacOS X Mojave/Homebrew
Homebrew (or just brew) is a third-party package manager
for MacOS.
If you have not installed brew, you must do so before installing the K
Framework brew package.
With brew installed, do the following to install the K Framework brew package
(with build number BN
):
brew install kframework--X.Y.Z.ID.bottle.BN.tar.gz -v
Note: we do not yet have a MacOS Monterey bottle. The existing brew package
also does not work on M1 Silicon Macs. If you have either of these systems,
you should build from source for the time being.
Homebrew Alternate Installation
To directly install the latest K Framework brew package without needing to
download it separately, do the following:
brew install kframework/k/kframework
Or, to streamline future K Framework upgrades, you can tap
the K Framework
package repository. This lets future installations/upgrades/etc... use the
unprefixed package name.
brew tap kframework/k
brew install kframework
Docker Images
Docker images with K pre-installed are available at the
runtimeverification/kframework-k Docker Hub repository.
Each release at COMMIT_ID
has an image associated with it at
runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
.
The latest master
build Docker image can be accessed with COMMIT_ID
set to
master
.
To run the image directly:
docker run -it runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
and to make a Docker Image based on it, use the following line in your
Dockerfile
:
FROM runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
We also create Ubuntu 22.04 images with the ubuntu-jammy-COMMIT_ID
tags.
Testing Packages
The easiest way to test the K package is to copy a K tutorial language and
check if you can compile and run an included example.
-
Start by copying the K tutorial to some work directory
(e.g.$HOME/pl-tutorial
) from the K distribution root. Using a Linux
package, this command typically will be like:$ cp -R /usr/share/kframework/pl-tutorial $HOME/pl-tutorial
On macOS/brew, this command typically will be like:
$ cp -R /usr/local/share/kframework/pl-tutorial $HOME/pl-tutorial
This step is needed because sometimes only the
root
user can run the
examples in the default installation directory. -
Now you can try to run some programs:
$ cd $HOME/pl-tutorial/2_languages/1_simple/1_untyped $ make kompile $ krun tests/diverse/factorial.simple
K Framework Release 5.3.53
Installing the K Framework Package
We currently strive to provide packages for the following platforms:
- Ubuntu Focal Fossa (20.04) and Jammy Jellyfish (22.04)
- Debian Bullseye
- Arch Linux
- MacOS X Mojave/Homewbrew
- Docker Images
Pre-installation Notes
-
We do not currently support running K natively on Windows. To use K on
Windows 10, you are encouraged to install the
Windows Subsystem for Linux (version 2)
and follow the instructions for installing Ubuntu Focal.If you have already installed WSL, before proceeding, you will need to
enter the WSL environment. You can do this by:- opening up the command prompt (accessible by searching
cmd
or
command prompt
from the start menu); - using the
wsl.exe
command to access the WSL environment.
- opening up the command prompt (accessible by searching
-
To use K in other non-linux environments (e.g. Windows 8 or earlier),
you will need to use a virtual machine (VM) software. We assume you have:- Created a virtual machine
- Installed a Linux distribution (e.g. Ubuntu Focal Fossa) on your
virtual machine
Consult your virtual machine software if you need help with the above
steps. We recommend the free VirtualBox virtual machine software.Before proceeding, follow the virtual machine softare UI to start your
Linux virtual machine and enter the command line environment. -
WSL and virtual machine users should be aware that, if you use your web
browser to download the package, you will need to make it accessible to
the command line environment. For this reason, we recommend downloading the
package from the command line directly using a tool likewget
. For
example, you could copy the package download URL and then type:wget <package-download-url>
where
<package-download-url>
is replaced by the URL you just copied. -
K depends on version 4.8.15 of Z3, which may not be supplied by package
managers. If this is the case, it should be built and installed from source
following the
instructions in
the Z3 repository. Other versions (older and newer) are not supported by K,
and may lead to incorrect behaviour or performance issues.
Downloading Packages
Download the appropriate package from the GitHub, via the
Releases page.
Releases are generated as often as possible from master
build.
Installing Packages
For version X.Y.Z
, disto DISTRO
, and package ID ID
, the following
instructions tell you how to install on each system. Note that this typically
requires about ~1.4GB of dependencies and will take some time.
- On Linux systems, K will typically be installed under
/usr
. - On macOS/brew, K will typically be installed under
/usr/local
.
Ubuntu Focal (20.04)
sudo apt install ./kframework_X.Y.Z_amd64_focal.deb
Ubuntu Jammy (22.04)
sudo apt install ./kframework_X.Y.Z_amd64_jammy.deb
Debian Bullseye
sudo apt install ./kframework_X.Y.Z_amd64_bullseye.deb
Arch Linux
pacman -U ./kframework-git-X.Y.Z-1-x86_64.pkg.tar.zst
MacOS X Mojave/Homebrew
Homebrew (or just brew) is a third-party package manager
for MacOS.
If you have not installed brew, you must do so before installing the K
Framework brew package.
With brew installed, do the following to install the K Framework brew package
(with build number BN
):
brew install kframework--X.Y.Z.ID.bottle.BN.tar.gz -v
Note: we do not yet have a MacOS Monterey bottle. The existing brew package
also does not work on M1 Silicon Macs. If you have either of these systems,
you should build from source for the time being.
Homebrew Alternate Installation
To directly install the latest K Framework brew package without needing to
download it separately, do the following:
brew install kframework/k/kframework
Or, to streamline future K Framework upgrades, you can tap
the K Framework
package repository. This lets future installations/upgrades/etc... use the
unprefixed package name.
brew tap kframework/k
brew install kframework
Docker Images
Docker images with K pre-installed are available at the
runtimeverification/kframework-k Docker Hub repository.
Each release at COMMIT_ID
has an image associated with it at
runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
.
The latest master
build Docker image can be accessed with COMMIT_ID
set to
master
.
To run the image directly:
docker run -it runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
and to make a Docker Image based on it, use the following line in your
Dockerfile
:
FROM runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
We also create Ubuntu 22.04 images with the ubuntu-jammy-COMMIT_ID
tags.
Testing Packages
The easiest way to test the K package is to copy a K tutorial language and
check if you can compile and run an included example.
-
Start by copying the K tutorial to some work directory
(e.g.$HOME/pl-tutorial
) from the K distribution root. Using a Linux
package, this command typically will be like:$ cp -R /usr/share/kframework/pl-tutorial $HOME/pl-tutorial
On macOS/brew, this command typically will be like:
$ cp -R /usr/local/share/kframework/pl-tutorial $HOME/pl-tutorial
This step is needed because sometimes only the
root
user can run the
examples in the default installation directory. -
Now you can try to run some programs:
$ cd $HOME/pl-tutorial/2_languages/1_simple/1_untyped $ make kompile $ krun tests/diverse/factorial.simple
K Framework Release 5.3.52
Installing the K Framework Package
We currently strive to provide packages for the following platforms:
- Ubuntu Focal Fossa (20.04) and Jammy Jellyfish (22.04)
- Debian Bullseye
- Arch Linux
- MacOS X Mojave/Homewbrew
- Docker Images
Pre-installation Notes
-
We do not currently support running K natively on Windows. To use K on
Windows 10, you are encouraged to install the
Windows Subsystem for Linux (version 2)
and follow the instructions for installing Ubuntu Focal.If you have already installed WSL, before proceeding, you will need to
enter the WSL environment. You can do this by:- opening up the command prompt (accessible by searching
cmd
or
command prompt
from the start menu); - using the
wsl.exe
command to access the WSL environment.
- opening up the command prompt (accessible by searching
-
To use K in other non-linux environments (e.g. Windows 8 or earlier),
you will need to use a virtual machine (VM) software. We assume you have:- Created a virtual machine
- Installed a Linux distribution (e.g. Ubuntu Focal Fossa) on your
virtual machine
Consult your virtual machine software if you need help with the above
steps. We recommend the free VirtualBox virtual machine software.Before proceeding, follow the virtual machine softare UI to start your
Linux virtual machine and enter the command line environment. -
WSL and virtual machine users should be aware that, if you use your web
browser to download the package, you will need to make it accessible to
the command line environment. For this reason, we recommend downloading the
package from the command line directly using a tool likewget
. For
example, you could copy the package download URL and then type:wget <package-download-url>
where
<package-download-url>
is replaced by the URL you just copied. -
K depends on version 4.8.15 of Z3, which may not be supplied by package
managers. If this is the case, it should be built and installed from source
following the
instructions in
the Z3 repository. Other versions (older and newer) are not supported by K,
and may lead to incorrect behaviour or performance issues.
Downloading Packages
Download the appropriate package from the GitHub, via the
Releases page.
Releases are generated as often as possible from master
build.
Installing Packages
For version X.Y.Z
, disto DISTRO
, and package ID ID
, the following
instructions tell you how to install on each system. Note that this typically
requires about ~1.4GB of dependencies and will take some time.
- On Linux systems, K will typically be installed under
/usr
. - On macOS/brew, K will typically be installed under
/usr/local
.
Ubuntu Focal (20.04)
sudo apt install ./kframework_X.Y.Z_amd64_focal.deb
Ubuntu Jammy (22.04)
sudo apt install ./kframework_X.Y.Z_amd64_jammy.deb
Debian Bullseye
sudo apt install ./kframework_X.Y.Z_amd64_bullseye.deb
Arch Linux
pacman -U ./kframework-git-X.Y.Z-1-x86_64.pkg.tar.zst
MacOS X Mojave/Homebrew
Homebrew (or just brew) is a third-party package manager
for MacOS.
If you have not installed brew, you must do so before installing the K
Framework brew package.
With brew installed, do the following to install the K Framework brew package
(with build number BN
):
brew install kframework--X.Y.Z.ID.bottle.BN.tar.gz -v
Note: we do not yet have a MacOS Monterey bottle. The existing brew package
also does not work on M1 Silicon Macs. If you have either of these systems,
you should build from source for the time being.
Homebrew Alternate Installation
To directly install the latest K Framework brew package without needing to
download it separately, do the following:
brew install kframework/k/kframework
Or, to streamline future K Framework upgrades, you can tap
the K Framework
package repository. This lets future installations/upgrades/etc... use the
unprefixed package name.
brew tap kframework/k
brew install kframework
Docker Images
Docker images with K pre-installed are available at the
runtimeverification/kframework-k Docker Hub repository.
Each release at COMMIT_ID
has an image associated with it at
runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
.
The latest master
build Docker image can be accessed with COMMIT_ID
set to
master
.
To run the image directly:
docker run -it runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
and to make a Docker Image based on it, use the following line in your
Dockerfile
:
FROM runtimeverificationinc/kframework-k:ubuntu-focal-COMMIT_ID
We also create Ubuntu 22.04 images with the ubuntu-jammy-COMMIT_ID
tags.
Testing Packages
The easiest way to test the K package is to copy a K tutorial language and
check if you can compile and run an included example.
-
Start by copying the K tutorial to some work directory
(e.g.$HOME/pl-tutorial
) from the K distribution root. Using a Linux
package, this command typically will be like:$ cp -R /usr/share/kframework/pl-tutorial $HOME/pl-tutorial
On macOS/brew, this command typically will be like:
$ cp -R /usr/local/share/kframework/pl-tutorial $HOME/pl-tutorial
This step is needed because sometimes only the
root
user can run the
examples in the default installation directory. -
Now you can try to run some programs:
$ cd $HOME/pl-tutorial/2_languages/1_simple/1_untyped $ make kompile $ krun tests/diverse/factorial.simple