Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Installation

macOS & Linux (Script)

curl -fsSL https://raw.githubusercontent.com/juglans-ai/juglans/main/install.sh | sh

The script downloads the latest pre-built binary from GitHub Releases and installs it to ~/.juglans/bin/juglans. If that directory is not already on your PATH, the script prints the one line you need to add to your shell profile.

Windows

The install.sh script does not support Windows. Download juglans-windows-x64.zip directly from the latest GitHub Release, extract it, and add the folder containing juglans.exe to your PATH.

Homebrew tap and a PowerShell installer are planned but not yet shipped — use the manual download path for now.

Verify

juglans --version

You should see a version number like juglans 0.2.x. If you see command not found, check the Troubleshooting section below — the installer puts the binary at ~/.juglans/bin/juglans, which may not be on your PATH yet.

Run juglans --help to see all subcommands. See CLI Commands for the full reference.

Other Methods

Pre-built Binaries

Download from GitHub Releases:

PlatformDownload
macOS (Apple Silicon)juglans-darwin-arm64.tar.gz
macOS (Intel)juglans-darwin-x64.tar.gz
Linux (x64)juglans-linux-x64.tar.gz
Linux (ARM64)juglans-linux-arm64.tar.gz
Windows (x64)juglans-windows-x64.zip
# Example: Linux x64
curl -LO https://github.com/juglans-ai/juglans/releases/latest/download/juglans-linux-x64.tar.gz
tar -xzf juglans-linux-x64.tar.gz
sudo mv juglans /usr/local/bin/

Build from Source

Requires Rust 1.80+. If you don’t have Rust, install it first:

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

Then build juglans:

git clone https://github.com/juglans-ai/juglans.git
cd juglans
cargo install --path .

Docker

docker pull ghcr.io/juglans-ai/juglans:latest

docker run -it --rm \
  -v $(pwd):/workspace \
  ghcr.io/juglans-ai/juglans:latest \
  /workspace/hello.jg

Troubleshooting

command not found: juglans

Make sure the binary is in your PATH:

# Check where it was installed
which juglans || echo "Not in PATH"

# If installed via cargo:
export PATH="$HOME/.cargo/bin:$PATH"

# If installed manually:
export PATH="/usr/local/bin:$PATH"

OpenSSL errors on Linux

# Ubuntu/Debian
sudo apt install libssl-dev pkg-config

# Then rebuild
cargo install --path . --force

Permission denied

chmod +x /usr/local/bin/juglans

Next Step

Now that Juglans is installed, let’s create your first workflow: Quick Start →