Install
Download the SF Veritas Desktop App for your platform.
Download
Installation Notes
macOS
- Open the
.dmgfile and drag SF Veritas to your Applications folder - First launch: Select "Open" - our app is verified malware-free by Apple, so this is a one-time thing you need to do.
Windows
- Run the installer (
.exe) and follow the prompts
Since the app is not yet code-signed, Windows SmartScreen may show a warning:
- Click "More info"
- Click "Run anyway"
This is a one-time step for each new version.
Linux
AppImage:
chmod +x SF-Veritas-*.AppImage
./SF-Veritas-*.AppImage
Debian/Ubuntu (.deb):
sudo dpkg -i sf-veritas_*.deb
No special permissions or workarounds needed on Linux.
The Desktop App automatically checks for updates on startup. When a new version is available, you'll be prompted to download and install it.
Setup Wizard
When you first launch SF Veritas, the Setup Wizard will guide you through configuring Sailfish instrumentation for your applications. This automates the code integration process using your preferred AI coding assistant.
Step 1: Welcome
The wizard scans your machine for Git repositories and running processes that can be instrumented with Sailfish.

Click "Get Started" to begin the configuration process. The wizard will:
- Configure Scan - Set scan parameters for finding your projects
- Repositories - Discover Git repositories on your machine
- Processes - Detect running applications that can be instrumented
- Install - Generate and run the instrumentation commands
Step 2: Install with AI Assistant
After scanning, select your preferred AI coding assistant to run the installation. The wizard generates a prompt with all the necessary configuration for your detected projects.

Click "Install using Claude Code" (or select another AI tool from the dropdown) to:
- Open a terminal window
- Run the generated installation command
- Automatically configure Sailfish instrumentation in your codebase
Prefer to install manually? See Integrate with Your Code for step-by-step instructions.
Re-running Setup
You can re-run the Setup Wizard at any time from the Status page. This is useful when you:
- Add new repositories to your machine
- Start new applications you want to instrument
- Need to reconfigure existing instrumentation

On the Status page, find the Setup Status section and click "Re-run Setup" to launch the wizard again.
Next Steps
- Integrate with Your Code - Set up your backend and frontend
- How to Use - Learn to use the Console and Flamechart