artcc/openclient-llm
View on GitHub ↗Open-source native iOS, iPadOS & macOS LLM client for LiteLLM, Ollama and OpenAI-compatible APIs. Built with SwiftUI.
14 ★5 forksSwiftUpdated 20d ago
What you need to know
OpenClient — a native Apple open-source MCP client (iOS/iPadOS/macOS, Swift 6+/SwiftUI) that connects to your own OpenAI-compatible server (LiteLLM or Ollama), with streaming chat, multimodal attachments, MCP tool discovery/execution from servers configured on your backend, Apple Shortcuts/WidgetKit integration, and iCloud sync.
Install
macOS: download the latest signed and notarized .dmg from the Releases page. App Store listing id6761379499 (App Store build). Build from source: git clone https://github.com/ArtCC/openclient-llm.git, create a gitignored Secrets.xcconfig, and open openclient-llm.xcodeproj (Xcode 26+, iOS/macOS 26+ targets).
Usage
- •Configure your server URL in the app: LiteLLM http://your-server:4000, or direct Ollama http://your-server:11434/v1 (OpenClient appends API paths without adding/removing /v1).
- •Optional server API key is stored in Keychain and sent as a Bearer token.
- •Use MCP tools from servers configured on your LiteLLM backend — discover, enable, and execute them from the chat input bar.
- •Self-host with Docker Compose via the Ollama.md / LiteLLM.md guides; Ollama through LiteLLM unlocks multi-provider support and cost tracking.
Key features
- ✓Streaming responses with Markdown/code blocks; collapsible Thinking block; multimodal (photos, camera, PDF); drag-and-drop files; TTS/STT.
- ✓MCP tool support, agentic tool-calling loop, web search via your server's providers, image generation via LiteLLM image models.
- ✓Conversation management: branch, edit/regenerate, favorites/pins/tags, media gallery, deep links (openclient://chat?text=…), full JSON backup/restore, Private Chat.
- ✓Apple native: Shortcuts + Siri actions, Control Center toggle, seven home-screen widgets, menu-bar companion on macOS, iCloud sync.
- ✓Per-conversation system prompts/params, prompt-template library, memory, 10 app languages; AGPL-3.0.
Best for
Users who want a modern native Apple chat client that talks only to their own LiteLLM/Ollama server and consumes MCP tools configured there — no hosted provider lock-in.
Caveats
- ⚠OpenClient is an MCP CLIENT, not a server — it needs a running LiteLLM/Ollama/OpenAI-compatible backend to be useful.
- ⚠MCP support depends on servers configured on the LiteLLM backend; direct Ollama needs OpenAI-compatible /v1 endpoints.
- ⚠iOS 26+/macOS 26+ and (for source builds) Xcode 26+; AGPL-3.0 license.
- ⚠In-app feedback (Votice) requires the VOTICE_* secrets; empty placeholders are enough to build.
Platforms: iOS · iPadOS · macOS
Reviewed 2026-08-18
Topics
- Stars
- 14★
- Forks
- 5
- Language
- Swift
- License
- AGPL-3.0
- Created
- 2026-03-29
- Last push
- 2026-08-15