Installation¶

Get up and running with run-kit in minutes. Choose the installation method that works best for your system.

Prerequisites¶

Before installing run, ensure you have:

A terminal or command prompt
An internet connection (for downloading)
Administrator/root access (for some installation methods)

Language Toolchains

run shells out to real language toolchains. To execute code in a specific language, you need that language's runtime or compiler installed (e.g., python3, node, rustc, go, etc.).

Installation Methods¶

Cargo (Recommended)¶

If you have Rust installed, this is the simplest method:

cargo install run-kit

This will download, compile, and install run from crates.io.

Verify the installation:

run --version

Debian / Ubuntu¶

Download and install the .deb package:

curl -LO https://github.com/Esubaalew/run/releases/latest/download/run_amd64.deb
sudo dpkg -i run_amd64.deb

Verify the installation:

run --version

Windows (Scoop)¶

For Windows users with Scoop:

scoop install https://github.com/Esubaalew/run/releases/latest/download/run-scoop.json

Verify the installation:

run --version

Install Script (macOS / Linux)¶

Use the automated install script:

curl -fsSLO https://raw.githubusercontent.com/Esubaalew/run/master/scripts/install.sh
chmod +x install.sh
./install.sh --add-path

Verify the installation:

run --version

Manual Download¶

Download pre-built binaries directly from GitHub:

Go to the Releases page
Download the appropriate archive for your system:
run-*-x86_64-apple-darwin.tar.gz for macOS
run-*-x86_64-unknown-linux-gnu.tar.gz for Linux
run-*-x86_64-pc-windows-msvc.zip for Windows
Extract the archive
Move the run binary to a directory in your PATH

Example for Linux/macOS:

tar -xzf run-*-x86_64-unknown-linux-gnu.tar.gz
sudo mv run /usr/local/bin/

Verify the installation:

run --version

Build from Source¶

For the latest development version or to contribute:

git clone https://github.com/Esubaalew/run.git
cd run
cargo build --release
sudo cp target/release/run /usr/local/bin/

Verify the installation:

run --version

Installing Language Toolchains¶

To execute code in a specific language, you need that language's runtime or compiler installed:

Scripting Languages¶

# Python
sudo apt install python3        # Debian/Ubuntu
brew install python            # macOS

# Node.js (JavaScript)
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Ruby
sudo apt install ruby          # Debian/Ubuntu
brew install ruby              # macOS

Compiled Languages¶

# Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Go
wget https://go.dev/dl/go1.21.0.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.21.0.linux-amd64.tar.gz

# GCC (C/C++)
sudo apt install build-essential  # Debian/Ubuntu
xcode-select --install           # macOS

Check Supported Languages¶

To see the list of languages supported by the run tool:

run
>>> :languages

This will show all languages that the run tool supports. Note that to actually execute code in a specific language, you still need to have that language's runtime or compiler installed on your system.

Updating¶

Cargo¶

cargo install run-kit --force

Scoop¶

scoop update run

Uninstalling¶

Cargo¶

cargo uninstall run-kit

Scoop¶

scoop uninstall run

Manual¶

Simply remove the binary from your PATH:

sudo rm /usr/local/bin/run

Troubleshooting¶

Command not found¶

If you get command not found: run after installation:

Check if the binary is installed:
```
which run
```
Ensure the install directory is in your PATH:
```
echo $PATH
```

Add to PATH if needed:

# For bash
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# For zsh
echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Permission Denied¶

If you get permission errors:

# Make the binary executable
chmod +x /path/to/run

# Or install with sudo
sudo cp run /usr/local/bin/

Language Not Found¶

If a language isn't detected:

Verify the toolchain is installed:

python3 --version
node --version
rustc --version

Check if it's in your PATH:
```
which python3
which node
```
Try explicitly specifying the language:
```
run --lang python "print('hello')"
```

Next Steps¶

Now that you have run installed, let's get started:

Quickstart Guide First Steps