Install on Linux

Install AICHE on Linux using DEB package or AppImage. Native Wayland and X11 support. Ubuntu 22.04+, Debian 12+, Fedora 38+.

5 min read
Last updated: 4/7/2026
linuxubuntuinstallationsetup

Native Wayland (GNOME) and X11 support. Tested on Ubuntu 22.04+, Debian 12+, Fedora 38+.

AICHE on Linux

Installation

Option 1: DEB Package (Ubuntu/Debian)

sudo dpkg -i aiche-desktop_X.X.X_amd64.deb

Download from your downloads page. The DEB bundles Python 3.12, FFmpeg, ydotool, xclip, and xdotool - no system dependency conflicts.

Option 2: AppImage

chmod +x AICHE-Desktop-X.X.X.AppImage
./AICHE-Desktop-X.X.X.AppImage

Self-contained, no install needed. Auto-updates via embedded update tool.

Option 3: Snap (coming soon)

sudo snap install aiche-desktop --classic

Permissions

Microphone

Automatic on most distros. If recording fails, check PulseAudio/PipeWire is running and AICHE has mic access.

Smart Insert on Wayland (GNOME)

Smart Insert needs extra permissions on Wayland. AICHE shows a setup prompt on first use with a one-click fix. If it doesn't work, check the troubleshooting section below.

Floating Bar on Wayland

The floating recording overlay uses a GNOME Shell extension. The DEB package installs it automatically.

Sign In

  1. Click Sign In in the app
  2. Your browser opens for Google authentication
  3. Browser redirects back via aiche:// protocol handler (auto-registered on install)
  4. The app activates

Keyboard Shortcuts

Shortcut Action
Ctrl + Alt + R Start/stop recording
Ctrl + Alt + E Toggle Voice Code mute

Shortcuts registered via GNOME gsettings custom keybindings.

Features

Smart Insert

Text types into your focused window. Uses ydotool on Wayland, xdotool on X11.

Recording on Linux

Voice Code

Real-time streaming dictation via WebSocket. VAD neural model for voice detection. Floating overlay shows transcription. Auto-inserts into last focused window.

Personal Dictionary

Add words the AI gets wrong. Up to 50 entries. Server-side - works on all your devices.

AI Enhancements

Message Ready, Make English, Clean Language, Content Organize, Software Development vocabulary.

Cloud Sync

E2E encrypted. Set a passphrase - AICHE cannot read your data.

System Tray

Tray icon shows recording status. Click to show/hide.

Wayland vs X11

Both fully supported. Wayland is the primary target (Ubuntu default since 22.04). The app auto-detects your display server.

Wayland-specific: Floating bar uses GNOME Shell extension. Smart Insert uses ydotool.
X11-specific: Uses xcb platform plugin. Smart Insert uses xdotool.

Known Issues

  • Floating bar behind windows: GNOME extension needs to be enabled. Check Settings > Extensions.
  • Smart Insert doesn't work on Wayland: The app needs input device access. Re-run the setup from Settings or contact support.
  • Global hotkey not working: Re-register in GNOME Keyboard Settings > Custom Shortcuts.
  • AppImage won't start: Make sure the file is executable (right-click > Properties > Permissions).
  • No audio device: Check your audio system (PulseAudio or PipeWire) is running.
Back to Help Center