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

ai-chatai-clientapplebyokchatiosipadoslitellmllmllm-clientmacosmcpmodel-context-protocolollamaopen-sourceopenai-compatibleself-hostedself-hosted-aiswiftswiftui
Stars
14★
Forks
5
Language
Swift
License
AGPL-3.0
Created
2026-03-29
Last push
2026-08-15