Installation & Setup

This guide covers system requirements, platform-specific installation, permissions, and initial configuration to get Rephlo up and running on Windows, macOS, or Linux.

System Requirements

Requirement	Windows	macOS
OS Version	Windows 10+ (64-bit)	macOS 10.15 Catalina+
Architecture	x64	Apple Silicon (arm64) or Intel (x64)
Framework	.NET 10 Runtime	.NET 10 Runtime
RAM (Cloud)	4 GB minimum	4 GB minimum
RAM (Ollama)	16 GB+ recommended	16 GB+ recommended
GPU (Ollama)	NVIDIA 8 GB+ VRAM	Apple Silicon unified memory

Linux: Coming soon. Currently, Rephlo is available for Windows and macOS only. Check https://rephlo.app/download for updates.

Note: The .NET 10 runtime is bundled with the self-contained release packages. You do not need to install it separately.

Installation by Platform

Windows

Download the latest Rephlo-win-x64.zip (or .exe installer) from https://rephlo.app/download.
Extract the ZIP to a permanent location (e.g., C:\Program Files\Rephlo or %LOCALAPPDATA%\Rephlo), or run the installer.
Launch by double-clicking Rephlo.exe.

Windows SmartScreen: On the first run, Windows may show a SmartScreen warning because the application is not signed with an EV certificate. Click "More info" then "Run anyway" to proceed. This prompt only appears once.

┌─────────────────────────────────────────────────────────────────────────┐
│                     WINDOWS INSTALLATION STEPS                          │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   Step 1                Step 2                Step 3                    │
│   ┌──────────┐         ┌──────────┐         ┌──────────┐               │
│   │ Download │  ────>  │ Extract  │  ────>  │  Launch  │               │
│   │ .zip     │         │ to folder│         │  .exe    │               │
│   └──────────┘         └──────────┘         └──────────┘               │
│                                                                         │
│   Data location: %APPDATA%\Rephlo\                                      │
│   Database:      %APPDATA%\Rephlo\rephlo.db                             │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

macOS

Download the latest Rephlo-macos.dmg (or Rephlo-macos.zip) from https://rephlo.app/download.
Install by dragging Rephlo.app to your /Applications folder.
First launch: macOS Gatekeeper may block the app. Right-click Rephlo.app and select "Open", then click "Open" again in the confirmation dialog.
Grant permissions: Rephlo will display a PermissionPreCheckDialog on first launch (see the macOS Permission Setup section below).

┌─────────────────────────────────────────────────────────────────────────┐
│                      macOS INSTALLATION STEPS                           │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   Step 1                Step 2                Step 3                    │
│   ┌──────────┐         ┌──────────┐         ┌──────────┐               │
│   │ Download │  ────>  │ Drag to  │  ────>  │  Open    │               │
│   │ .dmg     │         │ /Apps    │         │  .app    │               │
│   └──────────┘         └──────────┘         └──────────┘               │
│                                                    │                    │
│                                                    ▼                    │
│                                            ┌──────────────┐             │
│                                            │  Permission  │             │
│                                            │  PreCheck    │             │
│                                            │  Dialog      │             │
│                                            └──────────────┘             │
│                                                                         │
│   Data location: ~/Library/Application Support/Rephlo/                  │
│   Database:      ~/Library/Application Support/Rephlo/rephlo.db         │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

Important: Rephlo must run as a .app bundle on macOS. Running via dotnet run from the terminal will not allow global hotkeys to function because macOS requires Accessibility permission to be granted to a signed .app binary.

Linux

Coming Soon: Rephlo for Linux is currently under development and will be available soon. Check back at https://rephlo.app/download for updates.

Windows and macOS are fully supported. If you're interested in Linux support, please stay tuned for announcements.

macOS Permission Setup

macOS requires explicit user consent for apps that monitor keyboard input (global hotkeys) and capture the screen. Rephlo needs two permissions to function fully:

Permission	Purpose	What Breaks Without It
Accessibility	Global hotkeys, text selection monitoring, key detection	Hotkeys do not trigger; overlay never appears
Screen Recording	Screenshot capture for visual AI commands	Screenshot commands fail silently

Step-by-Step Permission Grant

On first launch, Rephlo displays the PermissionPreCheckDialog automatically:

┌─────────────────────────────────────────────────────────────────────────┐
│                    PERMISSION PRECHECK DIALOG                           │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   ┌─────────────────────────────────────────────────────────────────┐   │
│   │  Rephlo needs permissions to work properly                      │   │
│   ├─────────────────────────────────────────────────────────────────┤   │
│   │                                                                 │   │
│   │  1. Accessibility                                  [ ] Granted  │   │
│   │     Required for global hotkeys and text detection              │   │
│   │     [Open System Settings]                                      │   │
│   │                                                                 │   │
│   │  2. Screen Recording                               [ ] Granted  │   │
│   │     Required for screenshot capture                             │   │
│   │     [Open System Settings]                                      │   │
│   │                                                                 │   │
│   │                                                                 │   │
│   │                     [Check Again]    [Skip for Now]              │   │
│   │                                                                 │   │
│   └─────────────────────────────────────────────────────────────────┘   │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

Follow these steps:

Accessibility Permission a. Click "Open System Settings" next to Accessibility. b. macOS opens System Settings > Privacy & Security > Accessibility. c. Find Rephlo in the list and toggle it ON. d. Return to the Rephlo dialog and click "Check Again".
Screen Recording Permission a. Click "Open System Settings" next to Screen Recording. b. macOS opens System Settings > Privacy & Security > Screen Recording. c. Find Rephlo in the list and toggle it ON. d. Return to the Rephlo dialog and click "Check Again".
Restart the app. Some permission changes on macOS require a full restart of the application to take effect. Quit Rephlo completely and relaunch it from /Applications.

Tip: If Rephlo does not appear in the permission lists, try launching the app once, then check again. macOS adds apps to the permission list after they first attempt to use the protected feature.

Warning: If you skip granting permissions, Rephlo will still launch and function for manual commands via the dashboard, but global hotkeys and screenshot capture will not work.

First Launch Configuration

When you first open Rephlo, the Welcome Screen presents three paths to get started:

┌─────────────────────────────────────────────────────────────────────────┐
│                         WELCOME SCREEN                                  │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   ┌─────────────────────────────────────────────────────────────────┐   │
│   │                     Welcome to Rephlo                           │   │
│   ├─────────────────────────────────────────────────────────────────┤   │
│   │                                                                 │   │
│   │  Choose how you would like to get started:                      │   │
│   │                                                                 │   │
│   │  ┌──────────────────────────────────────────────────────────┐   │   │
│   │  │  PATH A: Log In with OAuth                               │   │   │
│   │  │  Sign in with your Rephlo account for managed access     │   │   │
│   │  │  via the Dedicated API.                                  │   │   │
│   │  │                                         [Log In]         │   │   │
│   │  └──────────────────────────────────────────────────────────┘   │   │
│   │                                                                 │   │
│   │  ┌──────────────────────────────────────────────────────────┐   │   │
│   │  │  PATH B: Bring Your Own Key (BYOK)                       │   │   │
│   │  │  Use your own API keys from OpenAI, Anthropic, Google,   │   │   │
│   │  │  Groq, xAI, OpenRouter, Azure OpenAI, or Ollama.        │   │   │
│   │  │                                         [Set Up BYOK]    │   │   │
│   │  └──────────────────────────────────────────────────────────┘   │   │
│   │                                                                 │   │
│   │  ┌──────────────────────────────────────────────────────────┐   │   │
│   │  │  PATH C: Skip / Offline Mode                             │   │   │
│   │  │  Explore the app without configuring a provider.         │   │   │
│   │  │  You can set one up later in Settings.                   │   │   │
│   │  │                                         [Skip for Now]   │   │   │
│   │  └──────────────────────────────────────────────────────────┘   │   │
│   │                                                                 │   │
│   └─────────────────────────────────────────────────────────────────┘   │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

Best for users with a Rephlo account. Sign in to access the managed Dedicated API without needing your own API keys.

Path B: Bring Your Own Key (BYOK)

Best for power users who already have accounts with AI providers.

Go to Settings > LLM Providers.
Select your preferred provider (e.g., OpenAI, Anthropic, Google).
Enter your API Key.
Click Test Connection to verify.
Click Save.

Path C: Skip / Offline Mode

Explore the Rephlo dashboard, browse commands, and configure settings without any provider. You can set up a provider at any time from Settings > LLM Providers.

For Ollama (local/offline): Ensure Ollama is installed and running on your machine. In Rephlo Settings, select Ollama as the provider, enter the endpoint URL (default: http://localhost:11434), and select a model from the dropdown (e.g., llama3).

Verifying Installation

Look for the Rephlo icon in your system tray (Windows) or menu bar (macOS).

Platform	Where to Look
Windows	System tray area near the clock (bottom-right of the taskbar). Click the up-arrow if hidden.
macOS	Menu bar at the top-right of the screen, next to the system icons.

┌─────────────────────────────────────────────────────────────────────────┐
│                        SYSTEM TRAY ICON STATES                          │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                         │
│   ┌───────────────┐     ┌───────────────┐     ┌───────────────┐        │
│   │      [R]      │     │     [R~]      │     │     [R!]      │        │
│   │    (Solid)    │     │  (Animated)   │     │    (Alert)    │        │
│   └───────────────┘     └───────────────┘     └───────────────┘        │
│          │                     │                     │                  │
│          ▼                     ▼                     ▼                  │
│   ┌───────────────┐     ┌───────────────┐     ┌───────────────┐        │
│   │    READY      │     │  PROCESSING   │     │    ERROR      │        │
│   │               │     │               │     │               │        │
│   │ Rephlo is     │     │ AI request    │     │ Configuration │        │
│   │ running and   │     │ in progress   │     │ missing or    │        │
│   │ ready to use  │     │ or task       │     │ provider      │        │
│   │               │     │ executing     │     │ unavailable   │        │
│   └───────────────┘     └───────────────┘     └───────────────┘        │
│                                                                         │
│   Tray icon actions:                                                    │
│   - Left-click:  Open the Rephlo Dashboard                              │
│   - Right-click: Context menu with quick actions                        │
│                                                                         │
│   ┌──────────────────────┐                                              │
│   │ Open Dashboard       │                                              │
│   │ Settings             │                                              │
│   │ ─────────────────    │                                              │
│   │ Pause Rephlo         │                                              │
│   │ Check for Updates    │                                              │
│   │ ─────────────────    │                                              │
│   │ Exit                 │                                              │
│   └──────────────────────┘                                              │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

Normal Icon: Rephlo is running and ready.
Warning Icon: Configuration missing or error—check Settings.

App-Wide Zoom

Rephlo supports zooming the entire interface for accessibility:

Action	Windows	macOS
Zoom in	`Ctrl` + `+`	`Cmd` + `+`
Zoom out	`Ctrl` + `-`	`Cmd` + `-`
Reset zoom	`Ctrl` + `0`	`Cmd` + `0`

Data Storage Locations

Platform	Data Directory	Database File
Windows	`%APPDATA%\Rephlo\`	`rephlo.db`
macOS	`~/Library/Application Support/Rephlo/`	`rephlo.db`

Next Step: Let's run your first command in the First Use Walkthrough.

System Requirements​

Installation by Platform​

Windows​

macOS​

Linux​

macOS Permission Setup​

Step-by-Step Permission Grant​

First Launch Configuration​

Path A: OAuth Login (Dedicated API)​

Path B: Bring Your Own Key (BYOK)​

Path C: Skip / Offline Mode​

Verifying Installation​

App-Wide Zoom​

Data Storage Locations​