Getting StartedInstallation

Installation

Install JOEL with a single command:

Quick Install

curl -fsSL https://joel.val-x.com/api/install | bash

This will:

  1. Check for Rust (install if needed)
  2. Clone the JOEL repository
  3. Build the joel binary from source
  4. Install it to /usr/local/bin/joel
  5. Make it available globally

Verify Installation

After installation, verify that joel is available:

joel version

You should see:

JOEL Language v0.1.0
A polymodal programming language

Alternative Installation Methods

From Source

If you prefer to build from source:

# Clone the repository
git clone https://github.com/JJ-Dynamite/JOEL.git
cd JOEL
 
# Build and install
cargo build --release
sudo cp target/release/joel /usr/local/bin/joel

Local Installation (No sudo)

If you don’t have sudo access:

# Build the release binary
cargo build --release
 
# Add to your PATH (add to ~/.zshrc or ~/.bashrc)
export PATH="$PATH:$(pwd)/target/release"

Prerequisites

JOEL is written in Rust, so you’ll need:

  • Rust 1.70+ - Install from rustup.rs
  • Cargo - Comes with Rust installation

Install Rust

If you don’t have Rust installed:

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

Platform-Specific Instructions

macOS

# Install Rust (if needed)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
 
# Install JOEL
curl -fsSL https://joel.val-x.com/api/install | bash

Linux

# Install Rust (if needed)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
 
# Install JOEL
curl -fsSL https://joel.val-x.com/api/install | bash

Windows

# Install Rust from https://rustup.rs/
 
# Install JOEL
git clone https://github.com/JJ-Dynamite/JOEL.git
cd JOEL
cargo build --release
# Add target\release\joel.exe to your PATH

Troubleshooting

”command not found: cargo”

Install Rust from rustup.rs:

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

“joel: command not found” after installation

Make sure /usr/local/bin is in your PATH:

echo $PATH | grep /usr/local/bin

If not, add it:

export PATH="$PATH:/usr/local/bin"

Build errors

Make sure you have the latest Rust version:

rustup update

Uninstallation

To remove JOEL:

sudo rm /usr/local/bin/joel

Next Steps

IntroductionQuick Start