Install Feluda on Linux

System Requirements

Desktop Environment GTK 3 and WebKitGTK 4.1 required

Distributions Ubuntu 22.04+, Debian 12+, Fedora 38+, and others

Architecture x86-64 (AMD64) or ARM64

Memory 4 GB minimum, 8 GB+ recommended

Feluda uses WebKitGTK to render its interface. Most modern desktop distributions include the necessary libraries, but you may need to install them manually. See the library commands below.

Required System Libraries

Before installing Feluda, make sure GTK 3 and WebKitGTK 4.1 are present on your system. Pick the command for your distribution:

sudo apt install libgtk-3-0 libwebkit2gtk-4.1-0

sudo dnf install gtk3 webkit2gtk4.1

sudo zypper install gtk3 webkit2gtk-4_1

Install Feluda on Linux

Visit the Feluda download page to get the latest release for your system. Feluda is available in several formats:

AppImage (Recommended)

The AppImage bundles everything Feluda needs into a single file. No installation step required — just make it executable and run it.

Download the AppImage from the download page.
Open a terminal and make it executable:
chmod +x Feluda*.AppImage
Run the file by double-clicking it in your file manager, or from the terminal:
./Feluda*.AppImage

Tip: Move the AppImage to a permanent location like ~/Applications/ and create a desktop shortcut for easy access.

.deb Package (Debian / Ubuntu)

Download the .deb package from the download page, then install it with:

sudo apt install ./feluda*.deb

After installation, launch Feluda from your application menu or run feluda in the terminal.

.rpm Package (Fedora / RHEL / openSUSE)

Download the .rpm package from the download page, then install it with:

# Fedora / RHEL
sudo dnf install ./feluda*.rpm

# openSUSE
sudo zypper install ./feluda*.rpm

Standalone Binary

Download the standalone binary from the download page. Make it executable and place it wherever you like:

chmod +x feluda
sudo mv feluda /usr/local/bin/

This option gives you full control over where the application lives on your system.

Getting Started After Installation

The Dashboard appears — your central hub for everything in Feluda.
Open AI Providers from the sidebar and add at least one provider. Enter an API key for a cloud service (such as OpenAI, Anthropic, or Mistral) or point to a local AI server like Ollama or LM Studio.
Optionally, visit Secrets to store sensitive values securely in your system's keyring (libsecret, GNOME Keyring, or KDE Wallet).
You are ready! Open the Workbench for chat-style interaction, or the Studio to build visual AI workflows.

Link Your Account (Optional)

If you have a paid plan — Explorer, Creator, or Visionary — you can connect your desktop app to your feluda.ai account:

Go to the Synchronize page inside the app.
Follow the Link Device flow to connect your installation to your account.
Feluda activates your plan and downloads any Genes (add-on capabilities) you have purchased from the Gene Store.

Where Feluda Stores Data

Data	Location
Application binary	Wherever you installed it (e.g. `/usr/local/bin/feluda` for .deb/.rpm, or your chosen AppImage location)
Desktop entry	`/usr/share/applications/feluda.desktop`
User data (flows, journals, Genes, settings)	`~/.config/Feluda/` or `$XDG_CONFIG_HOME/Feluda/`
Secrets	System keyring (libsecret — GNOME Keyring, KDE Wallet, or similar)

Your personal data is stored in your home directory, so updates and reinstalls will not affect your flows or settings.

Updating Feluda

Download the latest version in your preferred format and install it the same way you did originally — it upgrades in place. Your flows, journals, Genes, and settings are never affected by updates.

For the full step-by-step process for each package format, see our dedicated guide to updating Feluda on Linux.

Troubleshooting

Feluda won't start or shows a blank window

The most common cause is a missing WebKitGTK 4.1 library. Use your package manager to verify it is installed. If the library is missing, install it using the commands in the Required System Libraries section above, then restart Feluda.

AppImage does not run

Make sure the file is marked as executable (chmod +x). If you see a FUSE-related error, install FUSE support for your distribution (e.g., sudo apt install libfuse2 on Ubuntu/Debian). Alternatively, you can extract and run the AppImage without FUSE by appending the --appimage-extract flag.

"No display" or "Cannot open display"

Feluda requires a graphical desktop environment (GNOME, KDE, XFCE, etc.). It cannot run in a headless or server-only setup. Make sure you are logged into a desktop session.

AI providers are not connecting

Double-check your API key on the AI Providers page. For local providers like Ollama or LM Studio, make sure the server is running and reachable at the configured URL (Ollama defaults to http://localhost:11434). Visit the Help Center for more details.