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.
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 -WaitRun 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 Name | Platform / Target | Size | SHA-256 Checksum |
|---|---|---|---|
| adesh-editor.exe | Windows x86_64 TUI Code Editor | 2.72 MB | bafaa23a7e2657346dd0ac371e4491aa9d1cb4ea0fadffdbcebb11eb1f0e74f8 |
| adesh-observatory-desktop.exe | Release Artifact | 12.7 MB | 5fdad45bb621b4d9441f9e34655b506b688ddc4de4413c94ff42cae7e13add48 |
| adesh.exe | Windows x86_64 Standalone CLI | 33.2 MB | be206cac0d0f42e550cd3719f73b3b3c470c46f54b6ed4ab9bff042891a37365 |
| adeshlang-0.3.0-1.aarch64.rpm | Fedora / RHEL ARM64 (RPM) | 46.5 MB | 9f675a853bfbd2d9019144ac868a929635b5efc11f15f055207b3b5e741727d1 |
| adeshlang-0.3.0-1.x86_64.rpm | Fedora / RHEL x86_64 (RPM) | 50.2 MB | a0e83798472b1a9e6e8a53487809b095f271572a411c0373a88127293765256f |
| AdeshLang-0.3.0-aarch64-linux-gnu.tar.xz | Linux ARM64 (Universal Tarball) | 31.2 MB | a95cd3831aae96b13c2fd88a58d064aff1d690cc1527e4c8037f565a4da99c83 |
| AdeshLang-0.3.0-aarch64-windows-portable.zip | Windows ARM64 (Portable ZIP) | 45.3 MB | eacdb9d7067abeb136883f4016a6730b41095bcac59a60ef87f2b86a1147b4c1 |
| AdeshLang-0.3.0-macos-aarch64.tar.xz | macOS Apple Silicon (Tarball) | 28.5 MB | 9e58d37436b9a387a32f47fa1ce3faba126fea293d25f42129bb8dc12cf6e458 |
| AdeshLang-0.3.0-macos-x86_64.tar.xz | macOS Intel x86_64 (Tarball) | 33.8 MB | b87666ec30fbc368dec394affab83ecc8e21686be59fc5b4314bf13ce9d51857 |
| AdeshLang-0.3.0-x86_64-linux-gnu.tar.xz | Linux x86_64 (Universal Tarball) | 35.9 MB | c17ddf589cde22444c660abeb24fbd3cc543cf876c1fba4ee7ce4bfa02c9ce1d |
| AdeshLang-0.3.0-x86_64-windows-portable.zip | Windows x86_64 (Portable ZIP) | 49.7 MB | 8f5db26d596f3ade5dcf5e101b243bc4f5873e63f35c7dcbfd1f787e73678a2e |
| AdeshLang-0.3.0-x86_64-windows-setup.exe | Windows x86_64 (Setup GUI) | 19.0 MB | e0fe15787c5118ebc60dad7b3416a46554a04e1ad6aaa8842475c46df0885b55 |
| adeshlang_0.3.0_amd64.deb | Debian / Ubuntu x86_64 (DEB) | 37.2 MB | 9daec421181fd61644ad79bad9c06b5fdf7591e59f9956927a5a59fc42275972 |
| adeshlang_0.3.0_arm64.deb | Debian / Ubuntu ARM64 (DEB) | 34.6 MB | 60ecac80dafa3851ba250fc2906a13b8ba14ee194b99c3085dc92204ae179712 |
| adeshlink.exe | Release Artifact | 3.79 MB | 0a3e813a4f58088d2306a98cc0f578ea7cc19f8677ace87f249536804c4a9d7e |
| adl.exe | Windows x86_64 Package Manager | 3.32 MB | b6fff40488975b28b28a3d03ab064f470a2e157e534de41d2c8782b084c23308 |
| als.exe | Windows x86_64 Language Server | 4.64 MB | 13930e08a4cc576c721695839a8179da94b52d66462d10a7b51c42c0c733009c |
| aro.exe | Release Artifact | 2.06 MB | d3a94b3062253c845fe1f90b56c1783df64123ef376df0bfbbba54fc7432817d |
| install-linux.sh | Release Artifact | 16.2 KB | d995a97ac4301e0fad5198a3944e4df037813a7d419f2739038f13d7207eaf1b |
| install-macos.sh | Release Artifact | 13.4 KB | fd73ac80e701be4aeba393fb304902f2dc714fbddd77b6f4cab66009a1cff878 |
| install-windows.ps1 | Release Artifact | 3.92 KB | 5ed23b53dee02237623433c315d04b792d63d51a47d3cb52333186d234ed9f48 |
| SHA256SUMS | All Checksums File | 2.87 KB | dd3d780407289127694037fbbf73ee0564fe94d0535ee812f6ebe13a728e8fc3 |
| toolchain-manifest.json | LLVM Toolchain Resolver Manifest | 4.14 KB | c90ac73985bfe49c0d89d9e6d7dc4ed5ed67d952732ff9a82f511db572678699 |
| AdeshLang-mobile-0.3.0-arm64-v8a.apk | Android ARM64-v8a (Recommended APK) | 62.7 MB | 43ef6e42aa3235322b659e71f2a6b942b75cea004477c8177264ea1ff505f296 |
| AdeshLang-mobile-0.3.0-universal.apk | Android Universal (All-in-One APK) | 135.4 MB | 094fd787e32a573bd0a694288d7ba24ea7ceec38485a1fe747ccf5f1c4550928 |
| AdeshLang-mobile-0.3.0-x86_64.apk | Android x86_64 (Emulators / ChromeOS) | 74.1 MB | 278b048fc55e6317240f9992c2da6e39fb5970a4a2144fcfa63e694aaf2ca0f5 |
| AdeshLang-mobile-0.3.0.aab | Android App Bundle (AAB Package) | 107.4 MB | b6453465967f1b69c53b8e1079d2c14f06d2afeb1bdc2e096c64163cccd61b10 |
| SHA256SUMS-mobile.txt | Release Artifact | 306 B | 5475d870f08bc0381450cd05e519017aeb110ebb40272d78dfc289720eaa72ad |
| adesh-vscode-0.3.0.vsix | VS Code Extension (VSIX Package) | 1.11 MB | 8394d41f2772a782f25405408916e56b64d871ab087e8d7bfeb6187363257d59 |
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-*.pkgor open.dmg. - 🐧 Linux: Install
adeshlang_0.3.0_amd64.deb(sudo dpkg -i ...) oradeshlang-0.3.0-1.x86_64.rpm. - 📱 Android: Sideload
AdeshLang-mobile-0.3.0-arm64-v8a.apk.
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
| Command | Purpose |
|---|---|
adesh toolchain current | Display the active toolchain path, Clang, and LLD linker locations. |
adesh toolchain list | List bundled and system-detected LLVM/MLIR toolchains. |
adesh toolchain check | Verify whether the active toolchain can compile native targets. |
adesh toolchain path | Print the path to the bundled toolchain root directory. |
adesh toolchain expose --system | Expose 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
| Command | Category | Description & Usage |
|---|---|---|
adesh doctor | Diagnostics | Run complete health check on compiler, backends, environment, and AI hardware acceleration drivers. |
adesh toolchain install | Toolchain | Provision, download, or bind LLVM, Clang, LLD, and MLIR for GPU kernels or the opt-in external-linker path. |
adesh toolchain current | Toolchain | Inspect the active compiler backend, sysroot, and tool locations. |
adesh repl | Execution | Launch the interactive Adesh REPL shell with multiline support. |
adesh run <file.adesh> | Execution | Execute Adesh source with the standard tree-walk interpreter. |
adesh run --njit <file> | Execution | Execute using the Cranelift Native JIT backend. |
adesh build <file.adesh> | Compilation | AOT compile source into standalone native machine binary. |
adesh editor | IDE Tool | Launch the built-in cross-platform Terminal UI (TUI) Code Editor. |
adesh check <file.adesh> | Linter | Run static analysis, type checking, and borrow checker without codegen. |
adesh fmt <file.adesh> | Formatter | Auto-format source files according to standard Adesh style guidelines. |
adesh lsp / als | Language Server | Launch the Adesh Language Server for VS Code, Cursor, and Windsurf integration. |
adl install <pkg> | Package Mgr | Install dependencies, libraries, or AI/ML model binding packages. |
Installation Instructions
🪟 Windows Installation
Graphical Setup (Recommended)
- Download AdeshLang-0.3.0-x86_64-windows-setup.exe.
- Run the installer and follow the on-screen prompts.
- Open PowerShell or Command Prompt and verify:
adesh --versionadesh doctor
Portable ZIP Archive
- Download AdeshLang-0.3.0-x86_64-windows-portable.zip.
- Extract the archive to your preferred directory (e.g.
C:\Adesh). - Add the
bindirectory to your userPATH.
🍏 macOS Installation
PKG Installer (Recommended)
- Download the PKG installer for your architecture:
- Apple Silicon (M1/M2/M3/M4): AdeshLang-0.3.0-aarch64-macos.pkg
- Intel: AdeshLang-0.3.0-x86_64-macos.pkg
- Double-click the
.pkgfile and follow the standard macOS installation wizard. - Open Terminal and run:
adesh --versionadesh doctor
DMG Drag-and-Drop
- Download the
.dmgimage (Apple Silicon DMG / Intel DMG). - Open the image and double-click
Install-Adesh.commandor 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
- Download adesh-vscode-0.3.0.vsix.
- In VS Code, open the Extensions view (
Ctrl+Shift+Xon Windows/Linux orCmd+Shift+Xon macOS). - Click the
...menu (Views and More Actions) at the top-right of the Extensions pane. - Select Install from VSIX...
- Select the downloaded
adesh-vscode-0.3.0.vsixfile 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)
- Download the ARM64-v8a APK on your Android device (or use the Universal APK).
- Open the downloaded
.apkfile. - If prompted, enable "Install unknown apps" in your Android Settings for your browser or file manager.
- 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