Skip to main content

Install AdeshLang

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

Direct Downloads (v0.3.0)​

🪟 Windows

Supports Windows 10 & 11 (x86_64 & ARM64).

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

Download Windows Setup (.exe) — 70.4 MB

Portable x86_64 (.zip) — 120.3 MB

Portable ARM64 (.zip) — 113.1 MB

🍏 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.

Apple Silicon Installer (.pkg) — 21.2 MB

Apple Silicon (.dmg) — 23.6 MB

Intel (.pkg) — 24.3 MB

Intel (.dmg) — 27.6 MB

🐧 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.

Debian/Ubuntu x86_64 (.deb) — 90.7 MB

Debian/Ubuntu ARM64 (.deb) — 86.0 MB

Fedora/RPM x86_64 — 117.5 MB

Universal Tarball (.tar.xz) — 83.5 MB

📱 Android

AdeshLang Mobile IDE and native execution environment for Android devices.

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

Download Android APK (ARM64) — 62.2 MB

Universal APK (134 MB)

x86_64 Emulator (73.5 MB)

💻 Visual Studio Code Extension

Official AdeshLang 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.

Download VS Code Extension (.vsix) — 11.11 MB

All Release Assets & SHA-256 Checksums​

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

File NamePlatform / TargetSizeSHA-256 Checksum
adesh-editor.exeWindows x86_64 TUI Code Editor2.64 MB5c269098ce40650043d9c58d3a8fae9e394a4fcc5836f25eeb14306f4f974f0f
adesh.exeWindows x86_64 Standalone CLI28.0 MBd4764090859e2df79b17118bed5b7ddbbe4c16f92fd7d3eafef4708c280a909d
adeshlang-0.3.0-1.aarch64.rpmFedora / RHEL ARM64 (RPM)111.1 MB01ad7a71f13de93a403875cc5d6b55589832fced8fc0de832df0ad7fdc815207
adeshlang-0.3.0-1.x86_64.rpmFedora / RHEL x86_64 (RPM)117.5 MB39843e5e8dd6bcee099647448d427a506aa89f29b0b3fb5e3baa055a00a6430c
AdeshLang-0.3.0-aarch64-linux-gnu.tar.xzLinux ARM64 (Universal Tarball)77.0 MB7f7c4366a2bbbade34b3b9d18fc7ef5877c453fc076dfb82b6fb570151b25a46
AdeshLang-0.3.0-aarch64-macos.dmgmacOS Apple Silicon (Disk Image DMG)23.6 MBa04c60be0e27c2a6ea09f10d3ff1957248f799ff555212e2b9b0f28d31578e83
AdeshLang-0.3.0-aarch64-macos.pkgmacOS Apple Silicon (Installer PKG)21.2 MBe380b1137ebb1d5c033f37a644fd22d4e269580b6fa87d88faf707cf7e2940ac
AdeshLang-0.3.0-aarch64-windows-portable.zipWindows ARM64 (Portable ZIP)113.1 MBb852c97ca87379298c24495064502992ecf2d56ca5b1b53484c332f9fecedfdc
AdeshLang-0.3.0-macos-aarch64.tar.xzmacOS Apple Silicon (Tarball)73.5 MBecafdbc6e40f50e38a4e4e976007dee20b6ca90351489ccff8a09458bf1ae18e
AdeshLang-0.3.0-macos-x86_64.tar.xzmacOS Intel x86_64 (Tarball)80.5 MBd9ac33eedbe846138d0d48672b6842751ca7dcd4e63650629d369babdfb02f4f
AdeshLang-0.3.0-x86_64-linux-gnu.tar.xzLinux x86_64 (Universal Tarball)83.5 MBaaad0631598cbf9bd42a81651675a93d818a569f68de37e799bce7a37d72e73d
AdeshLang-0.3.0-x86_64-macos.dmgmacOS Intel x86_64 (Disk Image DMG)27.6 MB25e20534c70aff49fad43d464993db4b32acf75efc0af5e10ba206388ff20d0e
AdeshLang-0.3.0-x86_64-macos.pkgmacOS Intel x86_64 (Installer PKG)24.3 MB3a99e53fc73827548a59cc9cff7f0a5cf66feb71c0565c2a6955de6a7ecb6f70
AdeshLang-0.3.0-x86_64-windows-portable.zipWindows x86_64 (Portable ZIP)120.3 MB18bfd32e2f1b1156e7d0ecb308768ccd8c3bcaff1e55f119e90b78bfe18089e6
AdeshLang-0.3.0-x86_64-windows-setup.exeWindows x86_64 (Setup GUI)70.4 MB3cef7c704abd37d9c97b2a7bb53478ad06ab0efa850c256ecf6c65ad55eb5bad
adeshlang_0.3.0_amd64.debDebian / Ubuntu x86_64 (DEB)90.7 MB03133a698e6d356e03fbd102ae23564a68a6ce6e71f2d47f8aa735c8785ca527
adeshlang_0.3.0_arm64.debDebian / Ubuntu ARM64 (DEB)86.0 MB7e015d0c5805d31fdacbaa49ae96e57e2a3562b67f1bc8361da31050f487e791
adl.exeWindows x86_64 Package Manager3.07 MBfd236a9cff9f7e0e5a9620f9d92356e91da0e3ffd76b6c9c117d479e0dcd3fe4
als.exeWindows x86_64 Language Server4.45 MB783131547d7ee3309895312fb6cc35601b44bc308d8cb8f1f53753c011b29f24
SHA256SUMSAll Checksums File2.68 KBdc044c6a83dc42165abc6de82b1ca96684d18a2663f5ad73aa6def18e64904ea
toolchain-manifest.jsonLLVM Toolchain Resolver Manifest3.64 KB3b6826ad365dc426cafb06e093b702c38693d9376030ca87c570fbbbf6353b12
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 AdeshLang on your system, verify diagnostics, configure optional toolchains, and begin coding.

Step 1: Install AdeshLang 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)

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

  • adesh repl — Interactive REPL shell.
  • adesh run <file.adesh> — Tree-walk bytecode interpreter.
  • adesh run --njit <file.adesh> — Ultra-fast Cranelift Native JIT engine (10× to 230× speedup).
  • 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 optional LLVM/MLIR toolchain is only required if you plan to use AOT static compilation (adesh build <file.adesh>) or GPU MLIR kernels.

# 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​

AdeshLang 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 AdeshLang 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 native compilation backends.
adesh toolchain currentToolchainInspect the active compiler backend, sysroot, and tool locations.
adesh replExecutionLaunch the interactive AdeshLang REPL shell with multiline support.
adesh run <file.adesh>ExecutionExecute AdeshLang source with the standard tree-walk interpreter.
adesh run --njit <file>ExecutionExecute using Cranelift Native JIT backend (10× to 230× speedups).
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 AdeshLang 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:\AdeshLang).
  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-AdeshLang.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.0/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.0/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.0/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 AdeshLang 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 AdeshLang 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 AdeshLang 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.0/SHA256SUMS | grep "<filename>" | sha256sum -c

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