Installation

Glitch AI Engine is available for Linux only. Download the build for your CPU architecture from the Download page, then install using either the .deb package (recommended for daily use) or the direct binary (quick test without installing).

Current release: v0.8.5-stable • Platform: Linux • Architectures: arm64 (AArch64) and amd64 (x86_64)

Before You Download - Check Your Architecture

Run this in your terminal to see which build you need:

uname -m

Output	Architecture	Download from
x86_64	amd64	amd64 files on Download page
aarch64 or arm64	arm64	arm64 files on Download page

If the output is something else (e.g. i686, riscv64), Glitch does not provide a build for that architecture yet.

Download Files

On the Download page you get two file types per architecture:

amd64 (x86_64)

File	Type	Best for
glitch_0.8.5_amd64.deb	Debian package	Permanent install - app menu, glitch CLI, apt management
glitch-v0.8.5-linux-amd64	Executable binary	Quick test - run directly, no system install

arm64 (AArch64)

File	Type	Best for
glitch_0.8.5_arm64.deb	Debian package	Permanent install - app menu, glitch CLI, apt management
glitch-v0.8.5-linux-arm64	Executable binary	Quick test - run directly, no system install

Choose Your Installation Method

.deb Package - Recommended

Install with dpkg. Glitch appears in your application launcher and as the glitch command. Easy to verify with apt show and remove with apt remove.

Direct Binary - Quick Test

Make executable and run immediately. No install step - ideal for trying Glitch before committing. Does not register in app menu or PATH.

Method 1 - Install from .deb (Recommended)

Use this when you want Glitch as a normal desktop app with launcher integration and CLI access.

amd64

Download glitch_0.8.5_amd64.deb from the Download page.
Open a terminal in the folder where the file was saved.
Install the package:

                        sudo dpkg -i glitch_0.8.5_amd64.deb
                        sudo apt install -f
                    

If dpkg reports missing dependencies, run the second command above.

arm64

Download glitch_0.8.5_arm64.deb from the Download page.
Open a terminal in the folder where the file was saved.
Install the package:

                        sudo dpkg -i glitch_0.8.5_arm64.deb
                        sudo apt install -f
                    

If dpkg reports missing dependencies, run the second command above.

Launch after .deb install

You can start Glitch in any of these ways:

Application menu - search for Glitch in your desktop app launcher and click to open.
Terminal - run glitch from any directory.
Version check - run glitch -v to print the installed version.

Method 2 - Run Direct Binary (Quick Test)

Use this when you want to try Glitch immediately without installing to the system. The binary is a standalone executable - no dpkg, no app menu entry, no glitch command on PATH unless you add it yourself.

amd64

Download glitch-v0.8.5-linux-amd64 from the Download page.
In a terminal, go to the download directory.
Make executable and run:

                        chmod +x glitch-v0.8.5-linux-amd64
                        ./glitch-v0.8.5-linux-amd64
                    

arm64

Download glitch-v0.8.5-linux-arm64 from the Download page.
In a terminal, go to the download directory.
Make executable and run:

                        chmod +x glitch-v0.8.5-linux-arm64
                        ./glitch-v0.8.5-linux-arm64
                    

Why use the binary? It skips packaging and system registration - useful for a one-off test, a USB stick, or when you do not have sudo access. For everyday use, the .deb install is simpler: app launcher, glitch command, and clean uninstall via apt.

.deb vs Direct Binary

	.deb package	Direct binary
Install	`sudo dpkg -i <file>.deb`	`chmod +x <file>` then `./<file>`
App launcher	Yes - search Glitch in app list	No - run from terminal only
CLI command	glitch available system-wide	Must use ./ path each time
Requires sudo	Yes (for install)	No
Uninstall	`sudo apt remove glitch`	Delete the file
Best for	Daily driver, production use	Quick evaluation, portable run

Verify Installation (.deb only)

After installing via .deb, confirm the package is registered with apt:

                        apt show glitch
                        glitch -v
                    

This should display package metadata (version, architecture, description). Expected version output includes v0.8.5-stable.

Remove / Uninstall (.deb only)

To remove Glitch when it was installed from the .deb package:

sudo apt remove glitch

This removes the application and the glitch CLI command. Your user config in ~/.config-vritrasecz/Glitch/ is not deleted automatically - remove that folder manually if you want a full clean slate.

Direct binary users: There is nothing to uninstall with apt. Stop the running process and delete the downloaded executable file. Config still lives in ~/.config-vritrasecz/Glitch/ if you ran the binary at least once.

System Requirements

OS: Modern Linux desktop (Debian/Ubuntu/Kali and derivatives tested)
Architecture: arm64 or amd64 only
Display: X11 or Wayland session with a desktop environment
Network: Required for Glitch AI. Terminal works offline.

Next Steps

Once Glitch is running:

Getting Started - interface tour and API key setup
Glitch AI Assistant - Send to AI and chat modes
Terminal Features - tabs, splits, and session restore