Kasper Agent for Linux

Install on Linux

1. Download the AppImage for your processor. To find which one you need, run this command: x86_64 means x64, and aarch64 means arm64.

   uname -m

   Copy

2. Make the AppImage executable.

   chmod +x KasperAgent-*.AppImage

   Copy

3. Run it. On the first start, Kasper Agent adds itself to your app launcher, so that kasperagent:// links open it.

   ./KasperAgent-*.AppImage

   Copy

4. Connect a provider, such as Codex with your ChatGPT plan or Claude Code with your Claude plan. Then describe the agent you want in one prompt and save it.

Ubuntu 23.10 or newer, and Debian 13

1. These distributions restrict the user namespaces that the Electron sandbox needs, so Kasper Agent exits during launch until you install its AppArmor profile. Take the profile out of the AppImage:

   ./KasperAgent-*.AppImage --appimage-extract resources/linux/kasperagent.apparmor

   Copy

2. Install the profile, then reload AppArmor:

   sudo install -m 0644 squashfs-root/resources/linux/kasperagent.apparmor /etc/apparmor.d/kasperagent
   sudo systemctl reload apparmor

   Copy

3. The profile applies to an AppImage in ~/Applications, ~/Desktop, ~/Downloads, ~/.local/bin or /opt/KasperAgent. Keep it in one of these, or edit the path in the profile before you install it. Do not start Kasper Agent with --no-sandbox: the sandbox is the boundary between a web page and the rest of your computer.

A server with no screen

1. On Ubuntu 24.04 with systemd, install Kasper Agent as an always-on server of your account, then sign in with an email code:

   curl -fsSL https://raw.githubusercontent.com/AhmedAlNeaimy/kasperagent/main/scripts/install-server.sh | sudo bash
   sudo kasperagent login

   Copy

2. Then use it from the desktop app, the mobile app or kasperagent.com/app.

Good to know

• Each release is tested on Ubuntu 24.04 on x64.
• Kasper Agent checks for new versions and updates itself.
• The AI provider you choose needs an internet connection. A local model needs none.
• Voice prompts are not available on Linux.
• Remote desktop works with the x64 AppImage in an X11 session, such as Xorg or Xvfb. It does not work under Wayland, and the arm64 AppImage does not include it.

Questions

Other systems