Skip to Content

LobeHub Setup

LobeHub  is a powerful open-source AI desktop client (macOS, Windows, Linux, Web) that supports multiple AI service providers.

OfoxAI supports four protocols in LobeHub:

ProtocolProviderAPI Proxy URLExample Models (partial)
OpenAI Chat (recommended)OpenAIhttps://api.ofox.ai/v1openai/gpt-4.1, openai/gpt-4.1-mini, openai/gpt-5.4-mini, etc.
OpenAI ResponseOpenAIhttps://api.ofox.ai/v1openai/gpt-4.1, openai/gpt-5.4-mini, GPT series only
ClaudeAnthropichttps://api.ofox.ai/anthropicanthropic/claude-sonnet-4.6, anthropic/claude-opus-4.6, anthropic/claude-haiku-4.5
GeminiGooglehttps://api.ofox.ai/geminigoogle/gemini-3.1-flash-lite-preview, google/gemini-3.1-pro-preview

Prerequisites

Setup Steps

Step 1: Open Settings

Launch LobeHub and click the Settings icon in the bottom left.

Open LobeHub Settings

Step 2: Go to AI Service Providers

In the settings sidebar, click AI Service Providers, then select the provider you want to configure.

Go to AI Service Providers

Step 3: Fill in the Configuration

Select the provider and fill in the details. Example using OpenAI Chat:

FieldValue
API KeyYour OfoxAI API Key
API Proxy URLhttps://api.ofox.ai/v1
Use Responses APIOff (OpenAI Chat) / On (OpenAI Response)

API Proxy URL by protocol:

ProtocolProviderAPI Proxy URL
OpenAI Chat / ResponseOpenAIhttps://api.ofox.ai/v1
ClaudeAnthropichttps://api.ofox.ai/anthropic
GeminiGooglehttps://api.ofox.ai/gemini

After filling in, select a model in the connectivity check field and click the check button. “Check passed” means the configuration is successful.

Fill in configuration and check connection

OpenAI Chat vs OpenAI Response: When “Use Responses API” is off, requests go to /v1/chat/completions (Chat). When on, requests go to /v1/responses (Response, GPT series only).

Start Using

After setup, go back to the main screen, click the model icon on the left of the input box to select a model, and start chatting.

Start chatting

Troubleshooting

Q: Connectivity check fails

  1. Make sure the API Proxy URL is correct (see table above)
  2. Make sure your API Key is copied in full from the OfoxAI Console 
  3. Check your network connection

Q: What’s the difference between OpenAI Chat and OpenAI Response?

Both use the same API Proxy URL https://api.ofox.ai/v1, but differ in request format:

  • OpenAI Chat (Responses API off): uses /v1/chat/completions, supports all models, best compatibility
  • OpenAI Response (Responses API on): uses /v1/responses, GPT series only, but supports new features like instructions caching — better for high-frequency use cases

Q: The model I want isn’t in the list

Click “Fetch model list” to auto-fetch, or click + to add a custom model. Use the provider/model-name format for the model ID, for example:

ModelModel ID
DeepSeek V3deepseek/deepseek-v3.2
Claude Sonnetanthropic/claude-sonnet-4.6
Gemini Flashgoogle/gemini-3.1-flash-lite-preview

See all models at Models .

Last updated on