Skip to main content
Perplexity Client is an Electron-based desktop application that provides a polished interface for interacting with Perplexity’s Sonar API. Unlike typical chat interfaces, it exposes advanced API parameters like temperature, top-p, and max tokens, making it ideal for developers who want fine-grained control over their AI interactions while enjoying a beautiful, macOS-inspired UI. Perplexity Client Interface

​
Features

  • Multiple Sonar Models with support for Sonar, Sonar Pro, and Sonar Reasoning Pro
  • Custom Spaces with save/load functionality for different use cases
  • API Parameter Controls including temperature, top-p, and max tokens adjustments
  • API Debugging Mode showing full request/response payloads for troubleshooting
  • Token Usage Tracking to monitor API consumption and costs
  • Focus Modes for specialized tasks like coding, writing, and research

​
Prerequisites

  • Node.js v16 or higher
  • npm or yarn
  • Perplexity API key

​
Installation

# Clone the repository
git clone https://github.com/straight-heart/Perplexity-client-.git
cd Perplexity-client-

# Install dependencies
npm install

npm run dev

​
Build

Build the application for your platform: 
npm run build:win    # Windows
npm run build:mac    # macOS
npm run build:linux  # Linux

​
Configuration

API keys are managed directly within the application:
  1. Launch the app and open Settings (gear icon)
  2. In the API Keys section, click Add Key
  3. Enter your Perplexity API key
  4. The key is stored securely and persists across sessions
For custom system prompts, use the Spaces feature to save and switch between different instruction sets.

​
Usage

  1. Launch: Run npm run dev or use the built application
  2. Add API Key: Open Settings and add your Perplexity API key
  3. Select Model: Use the dropdown to choose between Sonar variants
  4. Create Spaces: Set up custom system prompts for different tasks
  5. Chat: Start conversing with real-time streaming responses
  6. Debug: Enable API debugging to see full request/response details
  7. Track Usage: Monitor token consumption in the Settings panel

​
Screenshots

FeaturePreview
Spaces (Custom Instructions)Spaces
Model & Parameter ControlsParameters
API Debugging ModeDebug
Theme SelectionThemes

​
Limitations

  • Desktop only (Windows, macOS, Linux) — no mobile or web version
  • Requires internet connection for API calls
  • API key required for functionality