How cherryhq/cherry-studio works
Cherry Studio is a cross-platform AI desktop workstation. Users configure providers and models, then chat or run agents; related workflows search local knowledge, create images, use web and automation tools, and manage generated files. The graph keeps these product stages distinct and includes provider/runtime and knowledge ingestion/search layers. README statements establish the product capabilities; sampled source confirms selected provider, knowledge, agent-storage, and web-search relationships. Other feature links are omitted where implementation wiring was not shown.
Main entry points: orchestration Agent workflows · providers Provider setup · useConversationTurnController.ts Conversations · pluginEngine.ts AI runtime
Components 20
Desktop interaction
- Provider setup
packages/provider-registry/src/providers - Conversations
src/renderer/hooks/useConversationTurnController.ts
AI and agents
- AI runtime
packages/aiCore/src/core/runtime/pluginEngine.ts - Provider extensions
packages/aiCore/src/core/providers/core/ProviderExtension.ts - Agent workflows
packages/agent-behavior/src/orchestration - Agent workspace
src/main/ai/agents/AgentWorkspaceStorageService.ts
Knowledge and documents
- Knowledge ingestion
src/main/features/knowledge/ingestion/KnowledgeIngestionService.ts - Knowledge files
src/main/features/knowledge/pathStorage.ts - Knowledge search
src/main/features/knowledge/query/KnowledgeQueryService.ts - Document preview
packages/file-preview/src
Creative and tools
- Image creation
src/renderer - Web search
packages/web-search/src/createWebSearchClient.ts - Automation tools
src/main/ai/runtime - Skills and MCP
src/main/ai/runtime/agentMcpServers.ts - Mini Apps and gateway
src/main/features/miniApp
Workspace and storage
- File library
src/main/services/FileStorage.ts - Voice features
native/system-speech/src - Conversation history
src/renderer/components/history/useHistoryRecordsController.ts - Local and WebDAV backup
src/main/services
Other components
- Desktop user
Connections 22
- Desktop user → Provider setup: configures
README.md - Provider setup → Provider extensions: selects providers
- Desktop user → Conversations: starts chats
README.md - Conversations → AI runtime: requests model
- AI runtime → Provider extensions: resolves models
packages/aiCore/src/core/runtime/pluginEngine.ts - Desktop user → Agent workflows: runs tasks
README.md - Agent workflows → Agent workspace: uses workspace
README.md - Desktop user → Knowledge ingestion: adds sources
README.md - Knowledge ingestion → Knowledge files: stores source files
src/main/features/knowledge/ingestion/KnowledgeIngestionService.ts - Desktop user → Knowledge search: searches knowledge
README.md - Knowledge search → Knowledge files: reads indexed sources
src/main/features/knowledge/query/KnowledgeQueryService.ts - Desktop user → Document preview: opens documents
README.md - Desktop user → Image creation: creates images
README.md - Desktop user → Web search: searches web
README.md - Desktop user → Automation tools: automates tasks
README.md - Agent workflows → Automation tools: uses tools
README.md - Agent workflows → Skills and MCP: extends capabilities
README.md - Desktop user → Mini Apps and gateway: opens tools
README.md - Desktop user → File library: manages files
README.md - Desktop user → Voice features: dictates and listens
README.md - Desktop user → Conversation history: reviews history
README.md - Desktop user → Local and WebDAV backup: backs up data
README.md