Skip to content

Cherry Studio

Save provider connections in OcHub and import them through Cherry Studio's public Deep Link protocol.

Updated View as Markdown
For humans

Cherry Studio integration is import-only. OcHub keeps configuration details and editing drafts prepared for import and uses Cherry Studio’s public custom-URL protocol to hand them to the installed app. It does not edit Cherry Studio’s SQLite database or call its internal Electron IPC.

Import a provider

  1. Open Cherry Studio in the OcHub sidebar and select Add connection.
  2. Choose the matching protocol type: OpenAI Chat Completions, OpenAI Responses, Anthropic Messages, Gemini, Vertex AI, Vertex Anthropic, or Ollama.
  3. Enter the provider Base URL and API key. Save to OcHub retains a separate draft.
  4. Select Import in Cherry Studio in the editor when ready. Existing cards still offer Import.
  5. Cherry Studio opens its provider confirmation dialog. Review the provider name, endpoint, key, and type, then confirm there.

OcHub generates a cherrystudio://providers/api-keys Deep Link only when the button is clicked. The API key is taken from the selected configuration or draft; it is not automatically copied to the clipboard. The key is part of the local URL payload delivered to Cherry Studio, so use this action only on a trusted machine.

Saving a draft changes neither Cherry Studio nor an applied connection record. A request is sent only after it has been handed to the system; confirmation in Cherry Studio is still required. OcHub does not mark a pending import as enabled or offer undo without a complete recovery receipt. The unconfirmed draft remains.

Scope and limitations

  • Cherry Studio must be installed and registered as the handler for the cherrystudio:// scheme.
  • The public payload imports provider identity, Base URL, API key, and protocol type. Configure models and other Cherry-specific settings in Cherry Studio.
  • Importing the same provider ID can update it after Cherry Studio asks for confirmation.
  • Deleting a connection in OcHub deletes only OcHub’s saved copy. OcHub does not remove or synchronize the provider in Cherry Studio.
  • Import is available only for local connections. Remote-node actions and the background quick-switch menu intentionally exclude Cherry Studio.

If Cherry Studio does not open, launch it once so the URL scheme is registered, then try Import again.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close