Installation & Setup
This guide covers the system requirements, installation process, and initial configuration to get Rephlo up and running on your machine.
System Requirements
- Operating System: Windows 10 or Windows 11 (64-bit).
- Framework: .NET 8 Runtime (usually included, but good to have).
- Hardware:
- Minimum: 4GB RAM, generic CPU (for Cloud Providers).
- Recommended for Local Models (Ollama): 16GB+ RAM, NVIDIA GPU with 8GB+ VRAM.
Installation Steps
- Download: Obtain the latest release package (ZIP or Installer) from the official distribution source.
- Extract: If using a ZIP package, extract the contents to a permanent location (e.g.,
C:\Program Files\Rephloor%LOCALAPPDATA%\Rephlo). - Launch: Navigate to the folder and double-click
TextAssistant.exe.
Note: On the first run, Windows SmartScreen might prompt you since the application is unsigned. Click "More Info" -> "Run Anyway" to proceed.
First Launch Configuration
When you first open Rephlo, you will be greeted by the Onboarding Wizard or the Settings panel to configure your AI Provider. You generally have two choices:
┌─────────────────────────────────────────────────────────────────────────┐
│ FIRST-RUN SETUP WIZARD │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ Welcome to Rephlo [X] │ │
│ ├─────────────────────────────────────────────────────────────────┤ │
│ │ │ │
│ │ Step 1 of 3: Choose Your AI Provider │ │
│ │ │ │
│ │ ┌──────────────────┐ ┌──────────────────┐ │ │
│ │ │ CLOUD │ │ LOCAL │ │ │
│ │ │ ┌────────────┐ │ │ ┌────────────┐ │ │ │
│ │ │ │ OpenAI │ │ │ │ Ollama │ │ │ │
│ │ │ │ Anthropic │ │ │ │ │ │ │ │
│ │ │ │ Google │ │ │ │ 100% │ │ │ │
│ │ │ │ Groq │ │ │ │ Offline │ │ │ │
│ │ │ └────────────┘ │ │ └────────────┘ │ │ │
│ │ │ │ │ │ │ │
│ │ │ [Select] │ │ [Select] │ │ │
│ │ └──────────────────┘ └──────────────────┘ │ │
│ │ │ │
│ │ Progress: [=====> ] Step 1/3 │ │
│ │ │ │
│ │ [Back] [Next] [Skip for Now] │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
Option A: Bring Your Own Key (BYOK)
Best for power users who already have accounts with AI providers.
- Go to Settings > Providers.
- Select your preferred provider (e.g., OpenAI or Anthropic).
- Enter your API Key.
- Click Test Connection to verify.
- Click Save.
Option B: Local Models (Ollama)
Best for privacy and offline use.
- Ensure Ollama is installed and running on your machine.
- In Rephlo Settings, select Ollama as the provider.
- Enter the endpoint URL (default is usually
http://localhost:11434). - Select a model from the dropdown (e.g.,
llama3). - Save.
Verifying Installation
Look for the Rephlo Icon in your system tray (near the clock).
┌─────────────────────────────────────────────────────────────────────────┐
│ 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 │ │
│ └───────────────┘ └───────────────┘ └───────────────┘ │
│ │
│ Right-click the tray icon for quick actions: │
│ ┌──────────────────────┐ │
│ │ Open Dashboard │ │
│ │ Settings │ │
│ │ ───────────────── │ │
│ │ Pause Rephlo │ │
│ │ Check for Updates │ │
│ │ ───────────────── │ │
│ │ Exit │ │
│ └──────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
- Normal Icon: Rephlo is ready.
- Warning Icon: Configuration missing or error (check Settings).
Right-click the tray icon to access the Dashboard or Settings at any time.
Next Step: Let's run your first command in the First Use Walkthrough.