Skip to content

README.en.md

Latest commit

 

History

History
82 lines (55 loc) · 4.56 KB

README.en.md

File metadata and controls

82 lines (55 loc) · 4.56 KB

Proma

Next-generation AI desktop app with integrated agents. Local-first, multi-provider, fully open source.

中文

Proma Poster

Commercial Version Running in Parallel

Proma also offers a commercial version. If you need cloud features | stable and reliable API | cost-effective subscription plans | simple user experience, you're welcome to support the commercial version of Proma: https://proma.cool/download

The core vision of Proma is not to replace any particular software. Currently, only the infrastructure of Proma has been implemented. Going forward, Proma will continue to build multi-agent collaboration (personal and team), agent connections with external services, Tools and Skills consolidation, and the ability to proactively provide software and suggestions based on user understanding and memory. Proma is evolving rapidly with the help of VibeCoding tools. PRs are welcome!

Screenshots

Chat mode with multi-model switching and file attachment support. Proma Chat Mode Agent mode with general-purpose agent capabilities. Supports the full Claude series, MiniMax M2.1, Kimi K2.5, Zhipu GLM, and third-party channels. Elegant, clean, smooth, and confident streaming output. Proma Agent Mode Built-in Brainstorming and office suite Skills with MCP support. Automatically helps you find and install Skills through conversation. Proma Default Skills and Mcp Full-protocol LLM channel support for all domestic and international providers, configured via Base URL + API Key. Proma Mutili Provider Support

Features

  • Multi-Provider Support — Anthropic, OpenAI, Google, DeepSeek, MiniMax, Kimi, Zhipu GLM, and any OpenAI-compatible endpoint
  • AI Agent Mode — Autonomous general agent powered by Claude Agent SDK
  • Streaming & Thinking — Real-time streaming output with extended thinking visualization
  • Rich Rendering — Mermaid diagrams, syntax-highlighted code blocks, Markdown
  • Attachments & Documents — Upload images and parse PDF/Office/text files in conversations
  • Local-First — All data stored locally in ~/.proma/, no database, fully portable
  • Themes — Light and dark mode with system preference detection

Getting Started

Download the latest release for your platform:

Download Proma

Configuration

Adding a Channel

Go to Settings > Channels, click Add Channel, select a provider, and enter your API Key. Proma will auto-fill the correct API endpoint. Click Test Connection to verify, then Fetch Models to load available models.

Agent Mode (Anthropic Only)

Agent mode requires an Anthropic channel. After adding one, go to Settings > Agent to select your Anthropic channel and preferred model (Claude Sonnet 4 / Opus 4 recommended). The agent uses Claude Agent SDK under the hood.

Special Provider Endpoints

MiniMax, Kimi (Moonshot), and Zhipu GLM use dedicated API endpoints — these are auto-configured when you select the provider. All three support their programming membership plans for API access:

Provider Chat Mode Agent Mode Note
MiniMax https://api.minimaxi.com/v1 https://api.minimaxi.com/anthropic Supports MiniMax Pro membership
Kimi https://api.moonshot.cn/v1 https://api.moonshot.cn/anthropic Supports Moonshot developer plan
Zhipu GLM https://open.bigmodel.cn/api/paas/v4 https://open.bigmodel.cn/api/anthropic Supports Zhipu developer plan

Tech Stack

  • Runtime — Bun
  • Framework — Electron + React 18
  • State — Jotai
  • Styling — Tailwind CSS + shadcn/ui
  • Build — Vite (renderer) + esbuild (main/preload)
  • Language — TypeScript

Credits

Proma is built on the shoulders of these great projects:

License

MIT