Proma is a local-first desktop AI platform with Chat and Agent modes, supporting multiple runtimes, memory, and Skills, stored under ~/.proma/. Latest releases include v0.16.9 and v0.16.8 with feature updates.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Proma is a local-first AI desktop application that combines multi-model Chat, Agent mode, Skills, MCP, remote robot bridges, and memory capabilities within a single open-source client.
How it works
Proma runs two Agent runtimes (Claude Agent Runtime and Pi Agent Runtime) and supports switching between them per Agent session. It stores data locally under ~/.proma/ as JSON/JSONL files, and uses Electron + Bun-based architecture for the desktop app. It provides channels/configuration for AI providers, memory, search, and remote robot bridges.
Getting started
快速开始
- 下载开源版本并安装适用于 macOS Apple Silicon、macOS Intel 和 Windows 的安装包。
- 启动后完成环境检查，进入 设置 > 渠道 添加至少一个 AI 供应商渠道，填写 Base URL、API Key 和模型列表。
- Chat 模式可使用 OpenAI、Anthropic、Google 或 OpenAI 兼容协议的渠道。
- Agent 输入框下方可直接切换 Claude / Pi 内核；Pi 可使用任意已启用的模型渠道。
- 进入 设置 > Agent，选择默认 Agent 渠道、模型和工作区。
- 如需记忆、联网搜索、桥接等，在设置页对应 Tab 继续配置。
安装与运行命令
- 提供 Bun 相关命令与 Electron 打包脚本等细节，包含 Bun 安装依赖、开发与打包步骤，以及针对 Electron 的各自脚本。
- 具体命令列在 README 中的常用命令部分。
Recent releases
Latest release entries include:
- v0.16.9 0.16.9 (2026-08-05): # Proma v0.16.9 更新
- v0.16.8 0.16.8 (2026-08-03): # Proma v0.16.8 更新
- v0.16.7 0.16.7 (2026-08-01): # Proma v0.16.7 更新
- v0.16.5 0.16.5 (2026-07-31): # Proma v0.16.5 更新
- v0.16.3 0.16.3 (2026-07-30): # Proma v0.16.3 更新
Traction
Proma has 1923 stars and 235 forks as reported. Open issues count 128.
Behind the repo
The repository uses Bun as runtime, Electron 39, React 18 with TypeScript, Jotai for state, Tailwind CSS, Radix UI, TipTap, Mermaid/KaTeX for rendering, and Shiki for code highlighting. Agent runtimes include Claude: @anthropic-ai/claude-agent-sdk and Pi: @earendil-works/pi-* @0.80.3.
Caveats
Licensing: AGPL-3.0. The project stores data locally under ~/.proma/ with JSON/JSONL format, and uses encryption for API keys via Electron safeStorage in channels.json. No local database usage is stated. The README covers development commands and packaging notes.