Overview
Cherry Studio is a cross-platform desktop AI client that supports multiple LLM providers. Configure RedPill as a custom provider to access 218+ models with TEE protection through Cherry Studio’s beautiful interface.Cherry Studio provides a ChatGPT-like interface for Windows, macOS, and Linux with advanced features like multi-model chat and local LLM support.
Installation
Download Cherry Studio from:- macOS: cherry-studio.dmg
- Windows: cherry-studio.exe
- Linux: cherry-studio.AppImage
Adding RedPill as Custom Provider
Step 1: Open Settings
- Launch Cherry Studio
- Click Settings in the left navigation bar
- Select the Model Services tab
Step 2: Add Custom Provider
- Click the + Add button
- Fill in the configuration:
1
Provider Name
Enter:
RedPill AI
2
Provider Type
Select:
OpenAI
3
API Address
Enter:
https://api.redpill.ai/v1
Cherry Studio automatically appends
/chat/completions
. Just use the base URL ending with /v1
4
API Key
Enter your RedPill API key:
sk-your-api-key-here
Click the Test button to verify the connectionStep 3: Add Models
Click + Add in the models section and add your preferred models: Popular Models:Click the Manage button to auto-fetch all available RedPill models, then select which ones to add.
Complete Configuration Example
Using RedPill Models in Cherry Studio
1. Start a Chat
- Click the + button to create a new chat
- Select a RedPill model from the dropdown
- Start chatting!
2. Multi-Model Comparison
Cherry Studio allows comparing responses from multiple models:- Create a new chat
- Enable Multi-Model mode
-
Select multiple RedPill models:
openai/gpt-4o
for general tasksanthropic/claude-3.5-sonnet
for reasoningdeepseek/deepseek-chat
for coding
- Send one message and get responses from all models simultaneously
3. Model-Specific Settings
Configure per-model settings:- Temperature: Control randomness (0.0 - 2.0)
- Max Tokens: Limit response length
- Top P: Nucleus sampling parameter
- Presence Penalty: Reduce repetition
- Frequency Penalty: Encourage diversity
Advanced Configuration
Custom API Routes
If RedPill uses non-standard routes, you can specify the full path: Standard route (auto-appended):Environment-Specific Configurations
Create multiple RedPill configurations:-
Production RedPill
- Name:
RedPill Production
- API:
https://api.redpill.ai/v1
- Models: Production models only
- Name:
-
Testing RedPill
- Name:
RedPill Testing
- API:
https://api-test.redpill.ai/v1
- Models: Experimental models
- Name:
Vision Models Configuration
Add vision-capable models for image analysis:Features Available with RedPill
Multi-Model Chat
Compare responses from multiple models simultaneously
Streaming
Real-time streaming responses from all models
Image Analysis
Upload images with vision-capable models
Chat History
Save and search conversation history
Code Highlighting
Automatic syntax highlighting for code
Markdown Support
Rich markdown rendering
Export Chats
Export conversations as Markdown or JSON
Dark Mode
Beautiful dark theme support
Recommended Model Setup
For General Use
Add these models for everyday tasks:For Privacy-Sensitive Work
Use Phala confidential models:For Multilingual Support
Troubleshooting
Connection Test Fails
Connection Test Fails
Solutions:
- Verify API key is correct
- Check API base URL ends with
/v1
- Ensure internet connection is active
- Try removing and re-adding the provider
Models Not Loading
Models Not Loading
Solutions:
- Click Manage → Refresh to fetch models
- Manually add model IDs with provider prefix
- Verify API key has proper permissions
Responses Are Slow
Responses Are Slow
Solutions:
- Check your internet connection
- Try a faster model (e.g.,
google/gemini-2.0-flash
) - Reduce
max_tokens
in model settings
Images Not Working
Images Not Working
Solutions:
- Ensure you’re using a vision-capable model
- Models supporting images: GPT-4o, Claude 3.5, Gemini 2.0
- Check image file size (under 20MB recommended)
Cherry Studio Features
1. Assistant Presets
Create custom assistants with:- Pre-defined system prompts
- Specific model preferences
- Temperature and other settings
2. Quick Commands
Use/
commands in chat:
/clear
- Clear chat history/export
- Export conversation/model
- Switch model mid-conversation
3. File Upload
Upload files for analysis:- Images - Vision models can analyze
- Code files - AI can review and explain
- Documents - Summarize and extract info
4. Search History
Search through all past conversations:- Keyword search
- Filter by model
- Filter by date range
Best Practices
Model Selection
Model Selection
- GPT-4o: Best for general conversation
- Claude 3.5: Best for reasoning and analysis
- DeepSeek: Best for coding tasks
- Gemini Flash: Best for speed
- Phala models: Best for sensitive data
Multi-Model Usage
Multi-Model Usage
Use multi-model mode to:
- Compare different approaches
- Validate AI responses
- Find the best model for your task
- Get diverse perspectives
Privacy
Privacy
- All RedPill requests flow through TEE
- Use Phala models for end-to-end confidential AI
- Cherry Studio stores chats locally
- Export important conversations for backup
Cost Management
Cost Management
- Monitor usage in RedPill dashboard
- Use faster/cheaper models for simple tasks
- Set max_tokens to control costs
- Export chats to avoid re-processing
Comparison with Other Clients
Feature | Cherry Studio | ChatGPT Web | Claude.ai |
---|---|---|---|
Multi-Provider | ✅ 218+ models | ❌ OpenAI only | ❌ Claude only |
Local Storage | ✅ Private | ❌ Cloud | ❌ Cloud |
Multi-Model Chat | ✅ Yes | ❌ No | ❌ No |
TEE Protection | ✅ With RedPill | ❌ No | ❌ No |
Offline Mode | ✅ With local LLMs | ❌ No | ❌ No |
Open Source | ✅ Yes | ❌ No | ❌ No |
Alternative Providers in Cherry Studio
You can add multiple providers simultaneously:- RedPill - 218+ models with TEE protection
- OpenAI Direct - Direct OpenAI access
- Local LLMs - Ollama, LM Studio
- Other Services - Any OpenAI-compatible API