A next-generation local-first AI desktop application with universal Agent capabilities powered by Claude Agent SDK, featuring multi-provider LLM support, MCP protocol integration, and extensible Skills system.
Overview#
Proma is a local-first AI desktop application powered by Claude Agent SDK for universal Agent capabilities, featuring comprehensive LLM chat functionality. Supports multiple providers including Anthropic, OpenAI, Google, DeepSeek, MiniMax, Kimi, Zhipu GLM, and any OpenAI-compatible endpoints.
Core Features#
Agent Capabilities#
- Claude Agent SDK Integration: Autonomous planning, execution, and completion of complex tasks
- Permission System: Three modes - auto / explore / supervise, workspace-level persistent configuration
- Skills Extension: Web search, API calls, database queries; auto-discovery and installation via conversation
Interactive Experience#
- Streaming Output: Real-time streaming responses
- Thinking Mode: Visualized extended thinking process
- Rich Rendering: Mermaid diagrams, syntax-highlighted code blocks, Markdown rendering
- Theme Switching: Light/dark mode, follows system preference
Memory & Context#
- Shared memory between Chat and Agent modes; AI remembers user preferences, habits, and context across sessions
Document Processing#
- Image upload, PDF/Office/text file parsing
- Direct local file operations, generate Excel, PPT, Word documents
Protocol & Integration#
- MCP Connector: Support for Model Context Protocol, connect to GitHub, Slack, databases, and other external tools
Data & Privacy#
- Local-first: All data stored in
~/.proma/directory - No database dependency, fully portable
Platform Support#
- macOS (Apple Silicon / Intel)
- Windows
- Linux version pending confirmation
Installation#
Download installers from GitHub Releases, or build from source (requires Bun runtime):
git clone https://github.com/ErlichLiu/Proma.git
cd Proma
bun install
bun run dev
Provider Configuration#
Supports custom API endpoints, some providers require special endpoint configuration:
- MiniMax: Chat
https://api.minimaxi.com/v1, Agenthttps://api.minimaxi.com/anthropic - Kimi: Chat
https://api.moonshot.cn/v1, Agenthttps://api.moonshot.cn/anthropic - Zhipu GLM: Chat
https://open.bigmodel.cn/api/paas/v4, Agenthttps://open.bigmodel.cn/api/anthropic
Notes#
- Agent mode only supports Anthropic provider (based on Claude Agent SDK)
- Recommended models: Claude Sonnet 4 / Opus 4
- Current version: v0.5.0
- License: MIT License