{"id":47164934,"url":"https://github.com/prompd/prompd-app","last_synced_at":"2026-03-15T20:15:03.395Z","repository":{"id":344033730,"uuid":"1141388716","full_name":"Prompd/prompd-app","owner":"Prompd","description":"Open-source desktop IDE for building, composing, and deploying AI workflows","archived":false,"fork":false,"pushed_at":"2026-03-13T01:27:11.000Z","size":7763,"stargazers_count":2,"open_issues_count":21,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-13T01:39:38.310Z","etag":null,"topics":["ai","ai-workflows","desktop-app","developer-tools","electron","llm","open-source","prompt-engineering","react","typescript"],"latest_commit_sha":null,"homepage":"https://www.prompdhub.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Prompd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-24T19:09:22.000Z","updated_at":"2026-03-12T21:25:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Prompd/prompd-app","commit_stats":null,"previous_names":["prompd/prompd-app"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/Prompd/prompd-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prompd%2Fprompd-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prompd%2Fprompd-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prompd%2Fprompd-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prompd%2Fprompd-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Prompd","download_url":"https://codeload.github.com/Prompd/prompd-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Prompd%2Fprompd-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30457984,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-13T03:55:51.346Z","status":"ssl_error","status_checked_at":"2026-03-13T03:55:33.055Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-workflows","desktop-app","developer-tools","electron","llm","open-source","prompt-engineering","react","typescript"],"created_at":"2026-03-13T04:01:28.155Z","updated_at":"2026-03-13T04:01:29.024Z","avatar_url":"https://github.com/Prompd.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Prompd\n\nA local-first desktop application for creating, executing, and deploying AI workflows. Build composable prompts with visual editing, a professional code editor, and package-based inheritance.\n\n## What is Prompd?\n\nPrompd brings software engineering practices to AI prompt development. Instead of managing prompts as loose text files, Prompd treats them as structured, versioned, composable documents with typed parameters, inheritance, and dependency management.\n\n**Everything runs locally.** Your API keys, prompts, and data never leave your machine. LLM calls go directly from Prompd to provider APIs with zero intermediaries.\n\n\u003e **Platform:** Pre-built binaries are currently **Windows only**. Mac and Linux builds are coming soon. You can build from source on any platform today.\n\n## Download\n\n**[Download for Windows](https://github.com/prompd/prompd-app/releases/latest)** | [Build from Source](#quick-start)\n\n**Requirements:** Windows 10+ | 4GB RAM | 500MB disk space\n\n\u003c!-- SCREENSHOT: Design View - Open a .prmd file in Design View showing the WYSIWYG editor\n     with the provider bar (Anthropic/OpenAI tabs), parameter panel, and content sections.\n     Use the public-examples/prompts/topic-researcher.prmd file for a good example. --\u003e\n![Design View](docs/screenshots/design-view.png)\n\n## Key Features\n\n- **Visual Workflow Canvas** - Drag-and-drop editor with 27 node types: prompts, agents, parallel execution, loops, conditionals, error handling, database queries, MCP tools, and more\n- **Dual Code/Design View** - Switch between a WYSIWYG design editor and Monaco code editor with IntelliSense, syntax highlighting, and package completions\n- **10 LLM Providers** - OpenAI, Anthropic, Google Gemini, Groq, Mistral, Cohere, Together AI, Perplexity, DeepSeek, and local Ollama — plus any OpenAI-compatible endpoint\n- **Package Inheritance** - Prompts can inherit from and extend other prompts, just like classes in software: `inherits: \"@prompd/core@1.0.0/prompts/base.prmd\"`\n- **Execution History** - Track every run with cost tracking, success rates, timing, and full input/output history\n- **MCP Integration** - Connect to Model Context Protocol servers for tool discovery and execution\n- **Workflow Deployment** - Package and deploy workflows as persistent background services with cron scheduling and webhook triggers\n- **Registry** - Search, install, and publish prompt packages via [PrompdHub](https://prompdhub.ai)\n- **Offline Support** - Full functionality without internet after initial setup\n- **Database Nodes** - Query MongoDB, PostgreSQL, MySQL, SQLite, and Redis directly from workflows\n\n### Screenshots\n\n\u003c!-- SCREENSHOT: Workflow Canvas - Open a .pdflow file (e.g., search-topic.pdflow or chat-workflow.pdflow)\n     showing multiple connected nodes with parallel branches. Zoom out slightly to show the full flow. --\u003e\n| ![Workflow Canvas](docs/screenshots/workflow-canvas.png) | ![Code View](docs/screenshots/code-view.png) |\n|:---:|:---:|\n| **Workflow Canvas** - Visual node editor with parallel branching | **Code View** - Monaco editor with IntelliSense and YAML validation |\n\n\u003c!-- SCREENSHOT: Code View - Open a .prmd file in Code View showing the Monaco editor with\n     YAML frontmatter syntax highlighting, IntelliSense completions visible, and the minimap. --\u003e\n\n\u003c!-- SCREENSHOT: Execution View - Run a prompt and capture the execution tab showing\n     the history panel with success rates, timing, cost, and the output preview. --\u003e\n| ![Execution](docs/screenshots/execution-view.png) | ![Package Inheritance](docs/screenshots/package-inheritance.png) |\n|:---:|:---:|\n| **Execution** - Run history with cost tracking and output preview | **Package Inheritance** - Versioned prompt dependencies |\n\n\u003c!-- SCREENSHOT: Package Inheritance - Open package-inheritance.prmd from public-examples\n     showing the inherits: field and how it resolves to a base prompt. --\u003e\n\n## Quick Start\n\n**Prerequisites:** Node.js 18+\n\n```bash\n# Clone the repository\ngit clone https://github.com/Prompd/prompd-app.git\ncd prompd-app\n\n# Build local packages (required before frontend)\ncd packages/scheduler \u0026\u0026 npm install \u0026\u0026 npm run build\ncd ../react \u0026\u0026 npm install \u0026\u0026 npm run build\n\n# Launch the desktop app\ncd ../../frontend \u0026\u0026 npm install\nnpm run electron:dev\n```\n\nThe app opens with a setup wizard that walks you through configuring your first API key and creating a prompt.\n\n## File Formats\n\n| Extension | Description | Structure |\n|-----------|-------------|-----------|\n| `.prmd` | Prompt files | YAML frontmatter + Markdown body |\n| `.pdflow` | Workflow definitions | YAML with visual node/edge data |\n| `.pdpkg` | Package archives | ZIP bundles with manifest.json |\n\nAll file references (`inherits:`, `context:`, `{% include %}`) resolve relative to the containing file's directory.\n\n## Tech Stack\n\n| Component | Technology |\n|-----------|------------|\n| Frontend | React 18 + TypeScript + Vite |\n| Desktop | Electron 40 |\n| State | Zustand with Immer |\n| Code Editor | Monaco Editor |\n| Workflow Canvas | XYFlow (React Flow) |\n| Prompt Compiler | [@prompd/cli](https://www.npmjs.com/package/@prompd/cli) |\n| Backend (optional) | Node.js + Express + MongoDB |\n\n## Architecture\n\n```\nUser Action -\u003e Electron IPC -\u003e Local Execution\n                             -\u003e Direct HTTPS to LLM APIs\n                             -\u003e @prompd/cli for compilation\n                             -\u003e SQLite for deployment state\n```\n\nThe backend API is optional and only used for provider/model list updates, registry package search, and cloud sync features. All core operations (compilation, execution, file management, scheduling) run entirely in the Electron main process.\n\n## Development\n\n### Project Structure\n\n```\nprompd-app/\n├── frontend/               # Electron + React application\n│   ├── src/modules/        # Components, services, editor\n│   ├── src/stores/         # Zustand state management\n│   └── electron/           # Main process (IPC, services)\n├── packages/\n│   ├── react/              # @prompd/react - Chat UI components\n│   └── scheduler/          # @prompd/scheduler - Deployment management\n├── backend/                # Optional REST API\n└── docs/                   # Documentation\n```\n\n### Commands\n\n```bash\n# Frontend\ncd frontend\nnpm run dev              # Vite dev server on :5173\nnpm run electron:dev     # Desktop app with hot reload\nnpm run electron:build:win   # Windows installer (NSIS + portable)\nnpm run electron:build:mac   # macOS (DMG + zip)\nnpm run electron:build:linux # Linux (AppImage + deb)\n\n# Backend (optional)\ncd backend\nnpm run dev              # Development server on :3010\nnpm test                 # Jest tests (requires MongoDB)\n\n# Packages\ncd packages/react \u0026\u0026 npm run dev    # Watch mode\ncd packages/scheduler \u0026\u0026 npm run dev # Watch mode\n```\n\n### Environment Setup\n\nCopy the example files and configure your values:\n\n```bash\ncp frontend/.env.example frontend/.env\ncp backend/.env.example backend/.env    # Only if using backend\n```\n\nAt minimum, you need one LLM provider API key (e.g., Anthropic or OpenAI) configured in `~/.prompd/config.yaml` or your workspace `.env` file.\n\n## Documentation\n\n- [CONTRIBUTING.md](CONTRIBUTING.md) - How to contribute\n- [docs/editor.md](docs/editor.md) - Editor features and usage\n- [frontend/ELECTRON.md](frontend/ELECTRON.md) - Build and distribution\n\n## License\n\nElastic License 2.0 (ELv2) - see [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprompd%2Fprompd-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprompd%2Fprompd-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprompd%2Fprompd-app/lists"}