Cherry Studio

Cherry Studio is an open-source cross-platform desktop client (macOS / Windows / Linux) for multi-model chat, knowledge bases, and agents. Plug in WRouter via its OpenAI-compatible provider and you get every model WRouter supports.

Prerequisites

Item	Requirement
Cherry Studio	≥ 1.0.0
WRouter	A working token

Install

Download from https://cherry-ai.com.

Configure

1. Add WRouter as a provider

Settings (gear) → Model providers → Add:

Field	Value
Type	OpenAI
Name	wrouter
API key	sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
API URL	https://wrouter.ai

Cherry appends /v1 automatically — don't include it.

Click Check — "Connection successful" confirms.

2. Load models

Inside the WRouter provider:

• Manage → Fetch from server — auto-populate; or
• Add — enter specific IDs

Enable the ones you'll use and pin favorites.

3. Default model (optional)

Settings → Default assistant → Default model: pick a WRouter model as the default for new chats.

Verify

1. Pick any WRouter model from the top-left selector
2. Send "Hello"; you should see a response
3. The top bar shows token usage and latency

Recommended models

Model	Use
claude-sonnet-4-6	Daily chat
claude-opus-4-8	Long-form writing, deep analysis
gpt-5.4	Multimodal chat (images, PDFs)
gemini-2.5-pro	1M-token context
deepseek-v4-pro	Reasoning
text-embedding-3-small	Knowledge base embeddings
tts-1	Read-aloud TTS

Advanced: knowledge base & voice

Knowledge base (embeddings)

Settings → Knowledge base → Embedding model:

• text-embedding-3-small (cost-effective) or bge-large-zh (Chinese)
• Reranker: bge-reranker-v2-m3 (see Rerank)

TTS / STT

Settings → Voice:

• TTS model: tts-1 or tts-1-hd
• Voice: alloy / nova / shimmer / …
• STT model: whisper-1

Troubleshooting

Symptom	Fix
Check fails with 401	Re-check API key; remove trailing spaces
Check fails with 404	API URL has /v1 — remove it
Empty model list	Click "Fetch from server"; verify token's group
Knowledge base indexing fails	Set an embeddings model; reduce chunk size
TTS plays silently	Browser autoplay policy; click once and retry

Known limitations

• The "web search" feature uses third-party search APIs, not WRouter.
• For native image generation, enable the "Image" toggle on the provider page.