Setup

Gunamaya on Windows

Native builds for both x64 and Arm64 Windows, with an installer or a fully portable option.

Choosing your download

Most Windows PCs are x64. Windows on Arm devices (like Surface Pro X and newer Snapdragon-based laptops) need the Arm64 build to run natively instead of through emulation. To check which you have, open Settings → System → About and look at System type.

Windows

x64
Arm64

macOS

Apple Silicon
Intel

Linux

x64
Arm64
Arm32

System Installer vs. User Installer

Gunamaya's Windows installer comes in two flavors:

User Installer (recommended)

Installs into your user profile — no administrator rights required, and each Windows user on a shared machine can have their own installation and settings.

System Installer

Installs machine-wide into Program Files, shared by every user account on the PC. Requires administrator rights. Preferred for locked-down or managed corporate machines.

Both installers register the .exe on your PATH

After installing either way, opening a terminal (PowerShell, Command Prompt, or Windows Terminal) and running gunamaya . will open the current folder in Gunamaya. If the command isn't found, restart your terminal — PATH changes only take effect in new terminal sessions.

Portable ZIP

If you'd rather not install anything — useful for USB drives, restricted machines, or just keeping multiple versions side by side — download the .zip archive instead of the installer, extract it anywhere, and run Gunamaya.exe directly. See Portable Mode for how Gunamaya decides where to store settings and extensions when run this way.

Windows-specific notes

1

Windows Defender / SmartScreen

On first run, Windows may show a SmartScreen prompt since the binary isn't yet trusted by Microsoft's reputation system. Choose More info → Run anyway. This is expected for any newly-released, independently signed application.

2

Long path support

Deeply nested project folders (common with some JavaScript tooling) can hit Windows' historical 260-character path limit. Gunamaya itself handles long paths correctly; if a build tool you're running still complains, enable long path support via Local Group Policy Editor → Computer Configuration → Administrative Templates → System → Filesystem → Enable Win32 long paths.

3

WSL for a Linux-native toolchain

If your project's tooling assumes a Linux environment, install the WSL extension and open your project from inside a WSL distribution — see Remote Development.

Uninstalling

Use Settings → Apps → Installed apps, search for Gunamaya, and choose Uninstall. This removes the application binaries; your workspace settings and extensions in %APPDATA%\Gunamaya are left untouched so a reinstall picks up where you left off. To remove those too, see Portable Mode & Uninstalling.