System Requirements
Install Feluda on macOS
- Visit the Feluda download page and download the binary that matches your Mac (Apple Silicon, Intel, or universal).
- Open Terminal, navigate to the folder where the file was downloaded, and make it executable:
chmod +x Feluda-darwin*
- Move the binary to a convenient location, for example:
mv Feluda-darwin* /usr/local/bin/feluda
You can also keep it in your home directory,
~/Applications/, or any other folder you prefer. - Run Feluda from Terminal:
feluda
Or double-click the binary in Finder. If Gatekeeper blocks it, see the troubleshooting section below.
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 the macOS Keychain.
- 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 placed it (e.g. /usr/local/bin/feluda) |
| User data (flows, journals, Genes, settings) | ~/Library/Application Support/Feluda/ |
| Secrets | macOS Keychain |
Your personal data is stored separately from the binary. Updates and reinstalls will not affect your flows or settings.
Updating Feluda
Download the latest binary from the download page and replace the previous file. Make it executable with chmod +x if needed. Your flows, journals, Genes, and settings are never affected by updates.
For the full step-by-step process, see our dedicated guide to updating Feluda on macOS.
Uninstalling Feluda
Delete the Feluda binary from wherever you placed it (e.g. /usr/local/bin/feluda). This removes the application. Your personal data in ~/Library/Application Support/Feluda/ is preserved — delete that folder manually if you want a complete removal.
Troubleshooting
If macOS says the app "cannot be opened," you have two options:
Option A (GUI): Open System Settings → Privacy & Security. Scroll down and you will see a message about Feluda being blocked. Click "Open Anyway."
Option B (Terminal): Run the following command once (replacing the path with the actual location of the binary), then open Feluda normally:
This clears the quarantine flag that macOS applies to downloaded files.
Try resetting the window state by deleting the preferences file. Open a terminal and run:
Then restart Feluda. If the problem persists, make sure your macOS version is 10.15 or later.
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.
The download page offers three options: Apple Silicon (for M1–M4 Macs), Intel (for older Intel-based Macs), and a universal binary that contains native code for both processor types. The universal binary is larger but works everywhere. If you know your Mac’s chip, the architecture-specific download is smaller and equally fast.
Ready to get started? Download Feluda for macOS and build your first AI workflow today.