proma-ai/Proma

Proma – A Desktop‑First AI Agent for Professionals

What it is – Proma is an open‑source, cross‑platform desktop application that lets power users interact with large language models (LLMs) as “agents”. It bundles a full UI (chat, planning, project/workspace management) together with a set of productivity tools (embedded browser, terminal, calendar/Todo integration, Obsidian‑style markdown editor, file diff viewer, etc.). The goal is to give professionals tighter control over context, memory, and tool use when working with AI.

Key capabilities

• Multiple interaction modes – plain chat, structured “agent” mode, and a planning mode.
• Project‑oriented workspace – each project has its own memory files (AGENTS.md, MEMORY.md), skills, and file set.
• Sub‑sessions & parallel exploration – spawn child sessions that keep a clean context, explore alternatives, then merge results back into the main conversation.
• Embedded tools – a visible terminal and a full‑featured browser that the agent can drive, plus built‑in calendar/Todo sync with macOS, and deep Obsidian‑style markdown editing.
• Skills / MCP / CLI – reusable, project‑scoped command bundles that the agent can invoke; commercial version adds team‑wide skill distribution.
• Remote connector support – can be linked to Slack, WeChat, Feishu, DingTalk, etc., so the agent can act in messaging platforms.
• Scheduling & automation – agents can create one‑off or recurring timed tasks (e.g., “run every 20 min between 10 am‑12 pm”).

Installation

• Pre‑built binaries are provided for macOS (Apple Silicon & Intel), Windows, and Linux (deb package & AppImage). Releases are on the GitHub Releases page.
• The open‑source edition requires the user to supply their own LLM API keys (OpenAI, Claude, Gemini, etc.) and any auxiliary services (web‑search, image generation).
• A commercial “Proma Cloud” edition offers bundled model access, managed APIs, and additional enterprise features; it can be installed over the open‑source version without losing data.

Open‑source vs. commercial

Feature	Open‑source	Commercial
Update cadence	Essential fixes only	Faster, richer updates
Model access	User‑provided API keys	Built‑in Proma Cloud models + user‑provided
Pricing	Pay provider directly	Discounted cloud rates (up to 10 % of list price)
Security/stability	User evaluates providers	Official hosted endpoints with health monitoring
Integrated services	Manual setup (search, image gen)	Full web‑search, GPT‑Image, etc.
Team management	DIY	Admin UI for quota, skill distribution, usage reports
API for external apps	Only third‑party keys	Proma Cloud API key with usage limits

Architecture & development

• Built with TypeScript, using Bun for scripts, Jotai for state, and a clear IPC contract between the main process and renderer.
• Extensible via JSON/JSONL configuration files; new skills or MCP (model‑command‑pipeline) definitions can be added without recompiling.
• Contributions are encouraged: bug fixes, documentation, tests, and new Skills/MCPs.

License

• Community edition is released under AGPL‑3.0. Commercial use is permitted under the same license, but a separate commercial license is offered for those who need to embed Proma in closed‑source products or SaaS offerings without the AGPL copyleft requirements.

Who might benefit

• Developers who want an AI‑assisted IDE with built‑in terminal and diff view.
• Knowledge‑workers using Obsidian or markdown‑heavy workflows.
• Teams that need shared AI “skills” and centralized quota management.
• Anyone looking for a desktop environment where an LLM can directly manipulate files, browse the web, and schedule tasks.

---

All information above is taken directly from the repository’s README; no additional features have been inferred.