Installation

There are several ways to install Keel on your system.

Pre-built Binaries

The easiest way to get started is to download a pre-built binary from the releases page.

Linux:

curl -L https://codeberg.org/Keel/keel-cli/releases/download/v0.0.20/keel-v0.0.20-linux-x86_64.tar.gz | tar xz
sudo mv keel /usr/local/bin/

Windows: Download keel-vX.Y.Z-windows-x86_64.zip from the releases page, extract it, and add the directory to your PATH.

Using Nix Flakes

The easiest way to get started with Keel is using Nix Flakes:

# Run directly without installing
nix run git+https://codeberg.org/Keel/keel-cli

# Or build the package
nix build git+https://codeberg.org/Keel/keel-cli

# Enter a development shell
nix develop git+https://codeberg.org/Keel/keel-cli

Building from Source

If you prefer to build from source:

# Clone the repository
git clone https://codeberg.org/Keel/keel-cli.git
cd keel-cli

# Build and install
cargo install --path .

This provides a single keel binary with all tools:

• keel run <file> — Execute a Keel file
• keel check <file> — Type-check without executing
• keel repl — Start the interactive REPL
• keel tui — Open the terminal UI (REPL + environment inspector + DataFrame viewer)
• keel fmt — Format source code
• keel lsp — Start the language server
• keel init — Create a new project from a template
• keel templates — List available project templates
• keel trace — Inspect compiler pipeline phases (AST, types, bytecode, execution)
• keel info — Show project manifest and permissions
• keel flow — Show data flow graph between task files
• keel graph — Show file dependency graph
• keel list — List .kl files in the project

Individual Tools

If you prefer standalone binaries, each tool is also available as a separate package:

• keel-repl — Interactive REPL
• keel-lsp — Language server
• keel-fmt — Code formatter

Jupyter Kernel (Optional)

For Jupyter notebook support, install the kernel separately:

cargo install --git https://codeberg.org/Keel/keel-jupyter-kernel
install-keel-kernel

See the Jupyter guide for details.

Prerequisites

• For Nix: Nix 2.4+ with flakes enabled
• For Source: Rust 1.85+ and Cargo (keel-core uses edition 2024)

Verify Installation

After installation, verify Keel is working:

keel --version

Next Steps

Now that you have Keel installed, proceed to Hello World to write your first program.