Install
Perfica is one download per system, published on the releases page.
| System | File | Architectures |
|---|---|---|
| Windows | Perfica-Setup-<version>.exe |
x64 |
| macOS | .dmg |
Intel (x64) and Apple silicon (arm64) |
| Linux | .AppImage |
x64 and arm64 |
Windows
Section titled “Windows”- Run the setup file.
- Choose where to install it. The installer is per user, so it does not need an administrator.
- Open Perfica from the Start menu.
Perfica’s builds are not code-signed yet, so Windows SmartScreen shows a warning the first time you run the installer. Choose More info, then Run anyway.
Updates arrive inside the app. By default Perfica downloads a new release in the background and installs it when you press Restart to update in the tray or Restart and update in Settings › General. If loops are running, it asks first: Update when idle, or Stop runs and update now.
Open the .dmg and drag Perfica into Applications.
macOS blocks it the first time because it is not signed: open System Settings › Privacy & Security and choose Open Anyway.
Because the macOS build is not signed, it cannot update itself. When a new version is out, download it from the releases page and install it over the old one.
Make the AppImage executable and run it:
chmod +x Perfica-*.AppImage./Perfica-*.AppImageThe AppImage updates itself in place when a new release is published.
Closing and quitting
Section titled “Closing and quitting”Closing the window does not quit Perfica. It keeps running in the tray, so loops carry on. To quit, use Quit Perfica in the tray menu. If anything is still running, Perfica asks before it stops, with Stop runs and quit.
What Perfica needs
Section titled “What Perfica needs”- Git for Windows on Windows, for agents to run command chains such as
npm install && npm test. Without it, only single commands run, and Perfica tells you where to get Git. - A model. A key for a hosted provider, or a local model through Ollama or LM Studio. See Add a provider key.
Next: First run.