# Heym

> AI-native workflow automation platform. Build, visualize, and run intelligent AI workflows without writing code.

Heym is a source-available, self-hostable automation platform purpose-built for AI workflows. It features a visual drag-and-drop canvas, multi-agent orchestration, built-in RAG pipelines, user-built workflow dashboards, MCP support, and a portable skills system.

Site search: https://heym.run/?s={query} (searches pages, templates, blog posts, and docs)

## Core Capabilities

- **Visual Workflow Editor**: Drag-and-drop canvas powered by Vue Flow with 61 node types across 7 categories (Triggers, AI, Logic, Data, Integrations, Automation, Utilities).
- **AI Assistant**: Describe what you want in natural language or voice, and the assistant generates nodes and edges and applies them to the canvas instantly.
- **User-Built Dashboards**: Build chart dashboards where every widget is powered by a hidden Heym workflow ending in a Chart Output node. Supports AI widget generation, fine-tuning, TTL caching, and drag-resize layouts.
- **Multi-Agent Orchestration**: One agent orchestrates named sub-agents and sub-workflows, all wired visually. Supports configurable reasoning effort, tool calling, and automatic model fallback.
- **Built-in RAG Pipeline**: Upload PDFs, Markdown, CSV, or JSON to managed QDrant vector stores. Wire a RAG node into any workflow for semantic search.
- **MCP Support**: Connect to MCP servers (as a client) or expose workflows as an MCP server for Claude Desktop, Cursor, and other clients.
- **Skills System**: Portable capability bundles (SKILL.md + optional Python tools) that extend agent context and toolbox via drag-and-drop.
- **Human-in-the-Loop**: Pause execution for user approval before proceeding.
- **Guardrails**: Content filtering, NSFW protection, and safety checks at the node level.
- **Parallel DAG Execution**: Independent nodes run concurrently based on graph structure.

## Tech Stack

- **Frontend**: Vue.js 3, TypeScript, Vite + Bun, Vue Flow, Pinia, Tailwind CSS, Shadcn Vue
- **Backend**: Python 3.11+, FastAPI, UV package manager, Alembic migrations
- **Database & Infra**: PostgreSQL 16, SQLAlchemy 2.0, Redis, RabbitMQ, Docker, QDrant
- **AI & LLM**: OpenAI, Ollama (local), vLLM, Cohere, MCP protocol, HITL, Evals
- **Security**: JWT auth, bcrypt, Pydantic v2 validation, Fernet encryption

## Platform Operations

Enterprise identity, high availability, and the audit trail ship in the source-available product. Details: https://heym.run/enterprise

- **Single sign-on (SSO)**: OpenID Connect against your own identity provider. Keycloak, Okta, Entra ID, Auth0, and Google connect from a single issuer URL, with Authorization Code and PKCE, encrypted client secrets, just-in-time account provisioning, domain-restricted access, and password-free sign-in once SSO is verified. Reference: https://heym.run/docs/reference/sso
- **High availability and horizontal scaling**: Additional instances join as workers against the same PostgreSQL database and share workflow execution through weighted load balancing you control. Leader election keeps cron schedules, alerts, and crash recovery running through a failover, and every run records the instance that executed it. Reference: https://heym.run/docs/reference/cluster
- **Audit logging**: An always-on audit trail covering every privileged action with actor, target, and outcome, streamed alongside your container logs into any SIEM or log collector for retention and search. Reference: https://heym.run/docs/reference/audit
- **Access control**: Role-based team permissions, encrypted credential storage, and credentials shared by reference so team members use them without seeing the secret values.
- **Deployment and data residency**: Self-hosted on Docker Compose or Kubernetes inside your own VPC or on-premises perimeter, with local model inference through Ollama or vLLM.

## Node Types

All 61 node types across 7 categories (Triggers, AI, Logic, Data, Integrations, Automation, Utilities). Each has a documentation page under https://heym.run/docs/nodes.

Input, Cron, Telegram Trigger, WebSocket Trigger, File Upload Trigger, Output, LLM, AI Agent, Codex, OpenCode Go, Condition, Switch, Wait, Execute, HTTP, WebSocket Send, Sticky Note, Merge, Set, Converter, Code, JSON output mapper, HTML output mapper, Slack, Discord, Telegram, Slack Trigger, Discord Trigger, IMAP Trigger, Send Email, Error Handler, Variable, Loop, Disable Node, Redis, RAG / Vector Store, Grist, GitHub, Linear, Jira, Google Sheets, Google Drive, DataTable, Throw Error, RabbitMQ, Crawler, Console Log, Playwright, Drive, Amazon S3, BigQuery, Supabase, ClickHouse, Notion, Sentry, MCP Call, Chart Output, Plugin, Plugin Trigger, Heym Trigger, Heym

## Documentation

Full documentation is on this site at https://heym.run/docs.

- **Getting Started** (https://heym.run/docs#getting-started): 6 pages. Install Heym, understand the canvas, and build a first workflow.
- **Node Reference** (https://heym.run/docs#nodes): 61 pages. Configuration, inputs, outputs, and expressions for every node type.
- **Dashboard Tabs** (https://heym.run/docs#tabs): 18 pages. What each dashboard tab manages and how permissions apply.
- **Reference** (https://heym.run/docs#reference): 43 pages. Expression DSL, agent architecture, guardrails, security, and platform internals.

Start here:

- [Core Concepts](https://heym.run/docs/getting-started/core-concepts)
- [Introduction](https://heym.run/docs/getting-started/introduction)
- [Migrate to Heym](https://heym.run/docs/getting-started/migrate-to-heym)
- [Quick Start](https://heym.run/docs/getting-started/quick-start)
- [Running & Deployment](https://heym.run/docs/getting-started/running-and-deployment)
- [Why Heym](https://heym.run/docs/getting-started/why-heym)

## Changelog

108 published releases, v0.0.109 being the latest (2026-09-12). The full history, including breaking changes and security fixes, is at https://heym.run/changelog. It is generated from the GitHub release tags at https://github.com/heymrun/heym/releases and refreshed hourly.

Most recent releases:

- **v0.0.109** (2026-09-12, https://heym.run/changelog#v0-0-109): Security Slack and Discord credentials now follow the same egress rules as the HTTP node, so webhook URLs must resolve to a public address. Reported by @unbengable12…
- **v0.0.108** (2026-09-10, https://heym.run/changelog#v0-0-108): Heym v0.0.108: 4 merged pull requests.
- **v0.0.107** (2026-09-08, https://heym.run/changelog#v0-0-107): Heym v0.0.107: 2 merged pull requests.
- **v0.0.106** (2026-09-05, https://heym.run/changelog#v0-0-106): Security acknowledgements Thank you to @roonakyadav for responsibly reporting credential exfiltration through the connection-test endpoint, where a collaborator holding a shared…
- **v0.0.105** (2026-09-03, https://heym.run/changelog#v0-0-105): Security acknowledgements Thank you to @fatihkaratash for responsibly reporting the credential-controlled base URL SSRF vulnerability across affected integrations and reporting…
- **v0.0.104** (2026-09-02, https://heym.run/changelog#v0-0-104): Heym v0.0.104: 4 merged pull requests.
- **v0.0.103** (2026-09-01, https://heym.run/changelog#v0-0-103): Heym v0.0.103: 2 merged pull requests.
- **v0.0.102** (2026-08-31, https://heym.run/changelog#v0-0-102): Heym v0.0.102: 3 merged pull requests.
- **v0.0.101** (2026-08-30, https://heym.run/changelog#v0-0-101): 📱 Mobile Workflow Canvas Redesign The mobile workflow page has been fully redesigned with a streamlined workflow tree and dedicated tabs for nodes, properties, run output, and…
- **v0.0.100** (2026-08-29, https://heym.run/changelog#v0-0-100): v0.100 — Worker Mode Heym can now run on more than one machine. ⭐️ Point a second instance at the same database and it joins as a worker. Your workflows are shared between them…

## Solutions

Heym helps AI, platform, and automation teams turn business processes into controlled, observable agentic systems, from company knowledge and human-reviewed operations to dashboards, observability, embedded backends, and evals. Overview: https://heym.run/solutions

- **Knowledge and Policy Systems** (https://heym.run/solutions/knowledge-systems): answers grounded in approved company knowledge with traceable sources and human review. Internal knowledge assistants, policy assistants, authenticated portals.
- **Human-Reviewed Operations** (https://heym.run/solutions/human-reviewed-operations): sensitive processes automated with human approval before important decisions or actions move forward. Legal, finance, compliance, content approval.
- **Multi-Agent Research and Processing** (https://heym.run/solutions/multi-agent-research): specialist agents that collect information, analyze findings, and produce structured reports. Market research, document extraction, report generation.
- **Self-Healing Browser Automation** (https://heym.run/solutions/browser-automation): Playwright steps or sandboxed Playwright Python with AI steps that repair broken selectors, cookie and storage state auth with login fallback, screenshots, and network capture.
- **Team Skills and Skill Operations** (https://heym.run/solutions/team-skills): skills bundling instructions, Python tools, and assets that whole teams reuse, with history and revert, Heym Drive file support, and MCP exposure to outside tools.
- **Live Operational Dashboards** (https://heym.run/solutions/operational-dashboards): dashboards where every chart widget is a workflow ending in a Chart Output node, with AI widget generation, fine-tuning, and TTL caching.
- **AI Observability and Cost Governance** (https://heym.run/solutions/ai-observability): traces for every agent run with payloads, tool calls, timing breakdowns, token and cost rollups per model, threshold alerts, and OpenTelemetry export.
- **Embedded AI Backends** (https://heym.run/solutions/embedded-ai-backends): workflows exposed as JSON APIs with bearer token auth, MCP servers, or authenticated portals, with structured outputs and async dispatch.
- **Evaluation and Release Gating** (https://heym.run/solutions/ai-evaluation): blind multi-model comparison, evals, and guardrails that test prompts and agent outputs before changes ship.

## Comparisons

Independent, source-linked product comparisons. Each page states where the other product can fit well and links to official vendor documentation; verify current capabilities, plans, pricing, and licensing with the vendor.

- **Comparison library** (https://heym.run/compare)
- **Heym vs n8n** (https://heym.run/compare/n8n)
- **Heym vs Zapier** (https://heym.run/compare/zapier)
- **Heym vs Make** (https://heym.run/compare/make)
- **Heym vs Pipedream** (https://heym.run/compare/pipedream)
- **Heym vs Activepieces** (https://heym.run/compare/activepieces)
- **Heym vs Microsoft Power Automate** (https://heym.run/compare/power-automate)
- **Heym vs Dify** (https://heym.run/compare/dify)
- **Heym vs Flowise** (https://heym.run/compare/flowise)
- **Heym vs Langflow** (https://heym.run/compare/langflow)
- **Heym vs Node-RED** (https://heym.run/compare/node-red)
- **Heym vs Windmill** (https://heym.run/compare/windmill)
- **Heym vs Gumloop** (https://heym.run/compare/gumloop)

## Use Cases

- **Customer Support**: RAG-powered knowledge base, human-in-the-loop escalation, multi-language support, Slack/email integration.
- **Data Processing**: Web crawling with Playwright/FlareSolverr, PDF extraction, LLM-powered data transformation, S3 object storage, Redis/PostgreSQL/vector store output, and dashboard widgets.
- **Content Generation**: Multi-agent research and writing pipelines, quality checks with guardrails, scheduled generation via cron.
- **DevOps**: Webhook triggers for CI/CD, AI-powered log analysis, automated incident response with approval gates.
- **Sales & Marketing**: Lead enrichment with web crawling, LLM-generated personalized outreach, CRM integration via HTTP/webhooks, and dashboard widgets for conversion metrics.

## Getting Started

```bash
git clone https://github.com/heymrun/heym.git
cd heym && cp .env.example .env
./run.sh
Ready at http://localhost:4017
```

## Links

- [Website](https://heym.run)
- [Documentation](https://heym.run/docs)
- [Solutions](https://heym.run/solutions): knowledge systems, human-reviewed operations, and multi-agent research as controlled agentic workflows
- [Platform](https://heym.run/platform): platform overview, use cases, tech stack, and frequently asked questions
- [Enterprise](https://heym.run/enterprise): single sign-on, multi-instance execution, streamed audit logs, commercial licensing, and production support
- [Templates](https://heym.run/templates)
- [Blog](https://heym.run/blog)
- [Changelog](https://heym.run/changelog): every published release with breaking changes, security fixes, and the merged pull requests behind each version
- [Playground](https://heym.run/playground): replays of real Heym runs, step by step, no signup
- [AI Convert](https://heym.run/convert): convert n8n, Make, Zapier, Node-RED, Windmill, Pipedream, Huginn, Flowise, Dify, Langflow, sim.ai, or Activepieces workflows to Heym
- [MCP endpoint](https://heym.run/mcp): public MCP server with site summary and site-wide search tools
- [GitHub](https://github.com/heymrun/heym)
- [Discord](https://discord.gg/T2wXvuVdMX)
- [Enterprise email](mailto:enterprise@heym.run)

## License

Commons Clause + MIT. Free to use, modify, and distribute. Not for commercial resale.