# heymrun/heym

> Heym is a self-hosted runtime and platform for building, orchestrating, running, observing, evaluating, and controlling agentic systems on your own infrastructure. It works by letting you define a workflow, a graph of agents, deterministic steps, tools, and data, which the runtime executes while recording execution history. The backend is written in Python, and the frontend uses Vue and TypeScript.

Source: https://github.com/heymrun/heym
Indexed: commit 9b62de8 on 2026-10-01 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: MCP server
- Language: Python
- Stars: 1,671 at index time
- Code health: 6.6/10, Fair
- Last commit: 2026-10-01
- Contributors: 28

## Install

From the README: https://github.com/heymrun/heym#-quick-start

Clone the heym repository.
    git clone https://github.com/heymrun/heym.git

Enter the repository directory.
    cd heym

Optionally create a .env file from the example file.
    cp .env.example .env

## How it works

The backend entry point is backend/app/main.py, and backend/app/api/workflows.py holds the workflow API routes. Database access goes through the async SQLAlchemy engine and session in backend/app/db/session.py, which connects to PostgreSQL. The workflow executor in backend/app/services/workflow_executor.py does the core work: it coordinates agents, deterministic nodes, sub-workflows, parallel branches, retries, and review checkpoints. Execution history and traces are recorded during runs, and the canvas can attach to an active execution to inspect it. The Vue frontend starts from frontend/src/main.ts and provides the canvas and dashboards. Database schema changes are managed with Alembic migrations in backend/alembic.

- backend/app/main.py: entry point
- frontend/src/App.vue: entry point
- frontend/src/main.ts: entry point
- .cursor/skills/heym-documentation/SKILL.md: central file
- .github/dependabot.yml: central file
Modules: backend, frontend, root, docker, scripts. 1,643 files, 294,386 lines, 20,286 symbols.

## Code health

- Score: 6.6/10 (Fair)
- Rank: #178 of 4,000+ indexed repos
- Hotspots: backend/app/services/workflow_executor.py, backend/app/api/ai_assistant.py, backend/app/api/workflows.py, frontend/src/components/Credentials/CredentialDialog.vue, frontend/src/components/Panels/DebugPanel.vue
- Lowest file: frontend/src/components/ui/ExpressionInput.vue
- Dead code: 80 findings

## Maintenance

- Last commit 2026-10-01, first commit 2026-04-27, 930 commits
- 28 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/heymrun/heym/security

## More

- Page: https://repowise.dev/repo/heymrun/heym
- Ask this codebase: https://repowise.dev/repo/heymrun/heym/chat
- Docs: https://repowise.dev/repo/heymrun/heym/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/heymrun/heym
