Skip to main content

Install Adesh

Official pre-built binaries, installers, and packages for Adesh v0.3.1 are available for Windows, macOS, Linux, and Android.

One-Line Install​

The command below matches the operating system you are browsing from. It fetches the pinned installer from GitHub Releases, detects your architecture, and puts adesh on your PATH.

PS >irm https://github.com/adeshlang/adeshlang/releases/download/v0.3.1/AdeshLang-0.3.0-x86_64-windows-setup.exe -OutFile adesh-setup.exe; start ./adesh-setup.exe -Wait

Run in PowerShell. Adds adesh to PATH; ARM64 builds are listed on the install page.

Setup .exe (x86_64)

Direct Downloads (v0.3.1)​

🪟 Windows

Supports Windows 10 & 11 (x86_64 & ARM64).

  • Setup Installer (x86_64): Recommended GUI installer.
  • Portable ZIP: Zero-install standalone archive.

🍏 macOS

Supports macOS 12 Monterey or newer (Apple Silicon & Intel).

  • Apple Silicon (M1/M2/M3/M4): Native ARM64 build.
  • Intel (x86_64): Native 64-bit Intel build.

🐧 Linux

Native packages for Ubuntu/Debian, Fedora/RHEL, and standalone tarballs.

  • DEB: Ubuntu, Debian, Pop!_OS, Mint.
  • RPM: Fedora, RHEL, CentOS, Rocky, openSUSE.
  • Tarball (.tar.xz): Universal standalone package.

📱 Android

Adesh Mobile IDE and native execution environment for Android devices.

  • ARM64-v8a APK: Recommended for physical devices.
  • Universal APK: Compatible with all 64-bit architectures.

💻 Visual Studio Code Extension

Official Adesh Language Support & ALS Language Server integration for VS Code and VS Code-based editors (Cursor, Windsurf, VSCodium).

  • Full ALS Language Server protocol integration with live diagnostic checks.
  • Semantic syntax highlighting, auto-completion, hover docs, and formatting.

All Release Assets & SHA-256 Checksums​

All official packages and binaries are cryptographically signed and checksummed in the Adesh Releases.

File NamePlatform / TargetSizeSHA-256 Checksum
adesh-editor.exeWindows x86_64 TUI Code Editor2.72 MBbafaa23a7e2657346dd0ac371e4491aa9d1cb4ea0fadffdbcebb11eb1f0e74f8
adesh-observatory-desktop.exeRelease Artifact12.7 MB5fdad45bb621b4d9441f9e34655b506b688ddc4de4413c94ff42cae7e13add48
adesh.exeWindows x86_64 Standalone CLI33.2 MBbe206cac0d0f42e550cd3719f73b3b3c470c46f54b6ed4ab9bff042891a37365
adeshlang-0.3.0-1.aarch64.rpmFedora / RHEL ARM64 (RPM)46.5 MB9f675a853bfbd2d9019144ac868a929635b5efc11f15f055207b3b5e741727d1
adeshlang-0.3.0-1.x86_64.rpmFedora / RHEL x86_64 (RPM)50.2 MBa0e83798472b1a9e6e8a53487809b095f271572a411c0373a88127293765256f
AdeshLang-0.3.0-aarch64-linux-gnu.tar.xzLinux ARM64 (Universal Tarball)31.2 MBa95cd3831aae96b13c2fd88a58d064aff1d690cc1527e4c8037f565a4da99c83
AdeshLang-0.3.0-aarch64-windows-portable.zipWindows ARM64 (Portable ZIP)45.3 MBeacdb9d7067abeb136883f4016a6730b41095bcac59a60ef87f2b86a1147b4c1
AdeshLang-0.3.0-macos-aarch64.tar.xzmacOS Apple Silicon (Tarball)28.5 MB9e58d37436b9a387a32f47fa1ce3faba126fea293d25f42129bb8dc12cf6e458
AdeshLang-0.3.0-macos-x86_64.tar.xzmacOS Intel x86_64 (Tarball)33.8 MBb87666ec30fbc368dec394affab83ecc8e21686be59fc5b4314bf13ce9d51857
AdeshLang-0.3.0-x86_64-linux-gnu.tar.xzLinux x86_64 (Universal Tarball)35.9 MBc17ddf589cde22444c660abeb24fbd3cc543cf876c1fba4ee7ce4bfa02c9ce1d
AdeshLang-0.3.0-x86_64-windows-portable.zipWindows x86_64 (Portable ZIP)49.7 MB8f5db26d596f3ade5dcf5e101b243bc4f5873e63f35c7dcbfd1f787e73678a2e
AdeshLang-0.3.0-x86_64-windows-setup.exeWindows x86_64 (Setup GUI)19.0 MBe0fe15787c5118ebc60dad7b3416a46554a04e1ad6aaa8842475c46df0885b55
adeshlang_0.3.0_amd64.debDebian / Ubuntu x86_64 (DEB)37.2 MB9daec421181fd61644ad79bad9c06b5fdf7591e59f9956927a5a59fc42275972
adeshlang_0.3.0_arm64.debDebian / Ubuntu ARM64 (DEB)34.6 MB60ecac80dafa3851ba250fc2906a13b8ba14ee194b99c3085dc92204ae179712
adeshlink.exeRelease Artifact3.79 MB0a3e813a4f58088d2306a98cc0f578ea7cc19f8677ace87f249536804c4a9d7e
adl.exeWindows x86_64 Package Manager3.32 MBb6fff40488975b28b28a3d03ab064f470a2e157e534de41d2c8782b084c23308
als.exeWindows x86_64 Language Server4.64 MB13930e08a4cc576c721695839a8179da94b52d66462d10a7b51c42c0c733009c
aro.exeRelease Artifact2.06 MBd3a94b3062253c845fe1f90b56c1783df64123ef376df0bfbbba54fc7432817d
install-linux.shRelease Artifact16.2 KBd995a97ac4301e0fad5198a3944e4df037813a7d419f2739038f13d7207eaf1b
install-macos.shRelease Artifact13.4 KBfd73ac80e701be4aeba393fb304902f2dc714fbddd77b6f4cab66009a1cff878
install-windows.ps1Release Artifact3.92 KB5ed23b53dee02237623433c315d04b792d63d51a47d3cb52333186d234ed9f48
SHA256SUMSAll Checksums File2.87 KBdd3d780407289127694037fbbf73ee0564fe94d0535ee812f6ebe13a728e8fc3
toolchain-manifest.jsonLLVM Toolchain Resolver Manifest4.14 KBc90ac73985bfe49c0d89d9e6d7dc4ed5ed67d952732ff9a82f511db572678699
AdeshLang-mobile-0.3.0-arm64-v8a.apkAndroid ARM64-v8a (Recommended APK)62.7 MB43ef6e42aa3235322b659e71f2a6b942b75cea004477c8177264ea1ff505f296
AdeshLang-mobile-0.3.0-universal.apkAndroid Universal (All-in-One APK)135.4 MB094fd787e32a573bd0a694288d7ba24ea7ceec38485a1fe747ccf5f1c4550928
AdeshLang-mobile-0.3.0-x86_64.apkAndroid x86_64 (Emulators / ChromeOS)74.1 MB278b048fc55e6317240f9992c2da6e39fb5970a4a2144fcfa63e694aaf2ca0f5
AdeshLang-mobile-0.3.0.aabAndroid App Bundle (AAB Package)107.4 MBb6453465967f1b69c53b8e1079d2c14f06d2afeb1bdc2e096c64163cccd61b10
SHA256SUMS-mobile.txtRelease Artifact306 B5475d870f08bc0381450cd05e519017aeb110ebb40272d78dfc289720eaa72ad
adesh-vscode-0.3.0.vsixVS Code Extension (VSIX Package)1.11 MB8394d41f2772a782f25405408916e56b64d871ab087e8d7bfeb6187363257d59


Installation & Toolchain Setup Flow​

Follow this 4-step flow to set up Adesh on your system, verify diagnostics, configure optional toolchains, and begin coding.


Step 1: Install Adesh Core Package​

Download and install the official package for your platform using the Direct Downloads or Platform-Specific Instructions below:

  • 🪟 Windows: Run AdeshLang-0.3.0-x86_64-windows-setup.exe (or extract portable ZIP).
  • 🍏 macOS: Run AdeshLang-0.3.0-*.pkg or open .dmg.
  • 🐧 Linux: Install adeshlang_0.3.0_amd64.deb (sudo dpkg -i ...) or adeshlang-0.3.0-1.x86_64.rpm.
  • 📱 Android: Sideload AdeshLang-mobile-0.3.0-arm64-v8a.apk.
Out-of-the-Box Execution (Zero External Dependencies)

Adesh's core features run immediately after Step 1 with zero external dependencies:

  • adesh repl — Interactive REPL shell.
  • adesh run <file.adesh> — Tree-walk reference interpreter.
  • adesh run --njit <file.adesh> — JIT Compiler (native machine code).
  • adesh build <file.adesh> — AOT native compilation without LLVM or external dependencies.
  • adesh check & adesh fmt — Static analysis, borrow-checker, and formatting.
  • als / adesh lsp — Language server for real-time IDE diagnostics.

Step 2: Verify Environment & Diagnostics​

After installing, verify the binaries and run the automated health check:

# Verify CLI is on PATH
adesh --version

# Run full system diagnostics (compilers, JIT runtime, GPU drivers, AI acceleration)
adesh doctor

# Inspect environment variables and resolved paths
adesh env
adesh env --json

Step 3: Toolchain Setup (adesh toolchain install) (Optional)​

The LLVM/MLIR toolchain is not needed for adesh build — native AOT compilation uses the bundled Adesh codegen and the adeshlink native linker. Install it only if you plan to use GPU / MLIR kernels, or the opt-in external-linker path (adesh build --codegen=cranelift --external-linker).

# Recommended on Linux (Ubuntu/Debian/Fedora/Arch) & macOS (Homebrew):
# Installs and registers native toolchain via your system package manager (apt/dnf/pacman/brew)
adesh toolchain install --use-system-packages

# Automated download & installation of pinned upstream toolchain:
adesh toolchain install

# For pre-release builds or custom environments:
adesh toolchain install --allow-unverified

# Install system-wide (requires admin / sudo):
sudo adesh toolchain install --system

Toolchain Diagnostics & Management Commands​

CommandPurpose
adesh toolchain currentDisplay the active toolchain path, Clang, and LLD linker locations.
adesh toolchain listList bundled and system-detected LLVM/MLIR toolchains.
adesh toolchain checkVerify whether the active toolchain can compile native targets.
adesh toolchain pathPrint the path to the bundled toolchain root directory.
adesh toolchain expose --systemExpose bundled LLVM/Clang tools system-wide for third-party programs.

Step 4: Editor & Developer Workflow Setup​

💻 VS Code / Cursor / Windsurf​

Install the official extension for syntax highlighting, autocomplete, code actions, and real-time ALS diagnostics:

# Download and install VSIX
curl -LO https://github.com/adeshlang/adeshlang/releases/download/vscode-v0.3.0/adesh-vscode-0.3.0.vsix
code --install-extension adesh-vscode-0.3.0.vsix

🖥️ Built-in Terminal UI (TUI) Editor​

Adesh includes a complete terminal-based code editor built-in. Launch it anytime without needing an external IDE:

adesh editor # Launch TUI editor
adesh-editor main.adesh # Edit specific file in TUI editor

🐳 Docker Container Quickstart​

If you prefer running Adesh in a fully isolated container with LLVM/MLIR and native toolchains pre-configured:

# Pull and start interactive REPL
docker run -it --rm adeshlang/adeshlang:latest adesh repl

# Execute local scripts inside container
docker run -it --rm -v "$(pwd):/app" adeshlang/adeshlang:latest adesh run /app/main.adesh

Essential Adesh Command Reference​

CommandCategoryDescription & Usage
adesh doctorDiagnosticsRun complete health check on compiler, backends, environment, and AI hardware acceleration drivers.
adesh toolchain installToolchainProvision, download, or bind LLVM, Clang, LLD, and MLIR for GPU kernels or the opt-in external-linker path.
adesh toolchain currentToolchainInspect the active compiler backend, sysroot, and tool locations.
adesh replExecutionLaunch the interactive Adesh REPL shell with multiline support.
adesh run <file.adesh>ExecutionExecute Adesh source with the standard tree-walk interpreter.
adesh run --njit <file>ExecutionExecute using the Cranelift Native JIT backend.
adesh build <file.adesh>CompilationAOT compile source into standalone native machine binary.
adesh editorIDE ToolLaunch the built-in cross-platform Terminal UI (TUI) Code Editor.
adesh check <file.adesh>LinterRun static analysis, type checking, and borrow checker without codegen.
adesh fmt <file.adesh>FormatterAuto-format source files according to standard Adesh style guidelines.
adesh lsp / alsLanguage ServerLaunch the Adesh Language Server for VS Code, Cursor, and Windsurf integration.
adl install <pkg>Package MgrInstall dependencies, libraries, or AI/ML model binding packages.

Installation Instructions​

🪟 Windows Installation​

  1. Download AdeshLang-0.3.0-x86_64-windows-setup.exe.
  2. Run the installer and follow the on-screen prompts.
  3. Open PowerShell or Command Prompt and verify:
    adesh --version
    adesh doctor

Portable ZIP Archive​

  1. Download AdeshLang-0.3.0-x86_64-windows-portable.zip.
  2. Extract the archive to your preferred directory (e.g. C:\Adesh).
  3. Add the bin directory to your user PATH.

🍏 macOS Installation​

  1. Download the PKG installer for your architecture:
  2. Double-click the .pkg file and follow the standard macOS installation wizard.
  3. Open Terminal and run:
    adesh --version
    adesh doctor

DMG Drag-and-Drop​

  1. Download the .dmg image (Apple Silicon DMG / Intel DMG).
  2. Open the image and double-click Install-Adesh.command or copy to /Library/Application Support/AdeshLang.

🐧 Linux Installation​

Debian / Ubuntu / Mint / Pop!_OS (.deb)​

# Download DEB package
curl -LO https://github.com/adeshlang/adeshlang/releases/download/v0.3.1/adeshlang_0.3.0_amd64.deb

# Install via dpkg / apt
sudo dpkg -i adeshlang_0.3.0_amd64.deb
sudo apt-get install -f # resolve any dependencies if needed

# Verify
adesh --version
adesh doctor

Fedora / RHEL / Rocky / CentOS (.rpm)​

# Download and install RPM
sudo rpm -Uvh https://github.com/adeshlang/adeshlang/releases/download/v0.3.1/adeshlang-0.3.0-1.x86_64.rpm

# Verify
adesh --version
adesh doctor

Universal Tarball (.tar.xz) — 83.5 MB​

# Download and extract tarball
curl -LO https://github.com/adeshlang/adeshlang/releases/download/v0.3.1/AdeshLang-0.3.0-x86_64-linux-gnu.tar.xz
tar -xf AdeshLang-0.3.0-x86_64-linux-gnu.tar.xz

# Move to local bin or export PATH
sudo cp -r AdeshLang-0.3.0-x86_64-linux-gnu/* /usr/local/

💻 Visual Studio Code Extension (.vsix)​

The official Adesh VS Code Extension integrates syntax highlighting, autocomplete, code actions, and real-time ALS language server diagnostics for VS Code, Cursor, Windsurf, and VSCodium.

Option 1: Install via VS Code Command Line (CLI)​

# Download the VSIX package
curl -LO https://github.com/adeshlang/adeshlang/releases/download/vscode-v0.3.0/adesh-vscode-0.3.0.vsix

# Install into VS Code
code --install-extension adesh-vscode-0.3.0.vsix

Option 2: Install via VS Code Graphical Interface​

  1. Download adesh-vscode-0.3.0.vsix.
  2. In VS Code, open the Extensions view (Ctrl+Shift+X on Windows/Linux or Cmd+Shift+X on macOS).
  3. Click the ... menu (Views and More Actions) at the top-right of the Extensions pane.
  4. Select Install from VSIX...
  5. Select the downloaded adesh-vscode-0.3.0.vsix file to install.

📱 Android Installation​

The Adesh Mobile App is a standalone code editor and native Adesh runtime environment for Android smartphones, tablets, and emulators.

Option 1: Direct Download & Sideload (Phone / Tablet)​

  1. Download the ARM64-v8a APK on your Android device (or use the Universal APK).
  2. Open the downloaded .apk file.
  3. If prompted, enable "Install unknown apps" in your Android Settings for your browser or file manager.
  4. Tap Install and launch Adesh Mobile.

Option 2: Install via Android Debug Bridge (ADB)​

# Download the ARM64 APK
curl -LO https://github.com/adeshlang/adeshlang/releases/download/mobile-v0.3.0/AdeshLang-mobile-0.3.0-arm64-v8a.apk

# Install to connected device via ADB
adb install AdeshLang-mobile-0.3.0-arm64-v8a.apk

Verifying Integrity​

You can verify the integrity of any downloaded package using the official SHA256SUMS file:

# Linux / macOS
curl -sL https://github.com/adeshlang/adeshlang/releases/download/v0.3.1/SHA256SUMS | grep "<filename>" | sha256sum -c

# Windows PowerShell
Get-FileHash -Algorithm SHA256 .\AdeshLang-0.3.0-x86_64-windows-setup.exe