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

1. Run the setup file.
2. Choose where to install it. The installer is per user, so it does not need an administrator.
3. 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 Install in the tray or in Settings. If loops are running, it offers to wait until they are idle or to stop them first.

macOS

Open the .dmg and drag Perfica into Applications.

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.

Linux

Make the AppImage executable and run it:

chmod +x Perfica-*.AppImage
./Perfica-*.AppImage

The AppImage updates itself in place when a new release is published.

Closing and quitting

Closing the window does not quit Perfica. It keeps running in the tray, so loops carry on. To quit, use Quit in the tray menu. If anything is still running, Perfica asks before it stops.

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, a free model, or a local model through Ollama or LM Studio. See First run on free models.

Next: First run on free models.