MCP server
heymrun / heym
Build agentic systems. Run them with confidence. Orchestrate agents, automate business processes, inspect every execution, and keep humans in control. Deploy Heym on your own infrastructure.
This connects Repowise to heymrun/heym's code. It does not install heym.
Repowise maps public repos from their source. Not affiliated with heymrun. What is Repowise?
github.com/heymrun/heymIndexed at 9b62de8
What is 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. To install it, run git clone https://github.com/heymrun/heym.git and follow the steps below. Its code health is 6.6 out of 10 (Fair), ranked #168 of 4,000+ indexed repos. The last commit to heym was on Oct 1, 2026, and 28 people have contributed.
As of commit 9b62de8, indexed Oct 1, 2026. What it is comes from a model reading the README; the rest is measured from the source and git history, not from the maintainer.
For agentsheym.md
Repo facts: type, license, health, rank, contributors
| Type | MCP server |
|---|---|
| Code health | 6.6 / 10 (Fair) |
| Health rank | #168 of 4,000+ indexed repos |
| Last commit | Oct 1, 2026 |
| Contributors | 28 |
| Bus factor | 1 |
| Size | 1,643 files, 294,386 lines |
Install heym
Commands copied from the README
- 1Clone the heym repository.
git clone https://github.com/heymrun/heym.git - 2Enter the repository directory
cd heym - 3Optionally create a .env file from the example file
cp .env.example .env
Releases on GitHub (latest v0.0.165, Nov 20, 2026)
Explore heym
- DocumentationModule-by-module documentation, 1,859 pages.
- ArchitectureDependency graph, layers and third-party dependencies.
- Code healthEvery file's score and the findings behind it.
- CommitsEach commit's effect on code health.
- OverviewEverything else the index found: contributors, decisions, what changed this week.
Ask about this code in your agent
This connects Repowise to heym's code. It does not install heym. To install heym, use the install steps.
Useful if you want to change or fork heym: your agent can ask how it is put together and get answers that cite its files.
Ask about heym
Answers come from heym's README and source, with the files they cite. Two free answers a day without an account.
Want this for your own codebase? Map your repo free
About this page
Get a page like this for your own codebase
Repowise built this map of heymrun/heym from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.
Free for 2 public repos, with a page like this one. No card. See how Repowise works
Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed. Star Repowise on GitHub
heymrun/heym FAQ
What is heym?
Heym is a self-hosted runtime and platform for building, orchestrating, running, observing, evaluating, and controlling agentic systems. You run it on your own infrastructure. Workflows combine agents, deterministic steps, tools, and data.
How does heym work?
Heym runs a workflow definition as a graph of agents, deterministic nodes, and tools. The executor coordinates dependent and parallel work, supports retries and review checkpoints, and records execution history.
How do I install heym?
Heym is installed by cloning its repository and running the run.sh script in the project directory. The script starts PostgreSQL, the backend, and the frontend, and generates SECRET_KEY and ENCRYPTION_KEY when needed. See the install steps
What language is heym written in?
Heym's backend is written in Python, and its frontend uses Vue and TypeScript. Python is the primary language of the repository.
How is the heym code organized?
Heym keeps its FastAPI backend in backend/app, with database setup in backend/app/db and migrations in backend/alembic. The Vue frontend is in the frontend directory, starting from frontend/src/main.ts.
Who is heym for?
Heym is for teams that want to build and operate agentic systems on their own infrastructure. It adds approval checkpoints, retries, execution visibility, and model cost tracking to those systems.
Code health
Hotspots average 4.1, the place fixes pay off most.
On the leaderboards:#47 of 67 Python repos
Key features of heym
- Visually compose agents and deterministic workflows, or generate them with AI.
- Connect models, tools, MCP, company knowledge, and internal systems to a workflow.
- Pause execution at approval checkpoints and resume from saved state after a human decision.
- Record input and output tokens and calculate USD costs per trace from maintained model pricing data.
- Serve workflows through REST, SSE streaming, MCP tools, and Portal chat interfaces.
How heymrun/heym 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.
The codebase has 1,643 files and 20,286 symbols in 5 modules, led by Python, Vue and TypeScript. Code health is 6.6 out of 10, rated fair.
Maintain heymrun/heym?
Claim this page, add a badge to the README, or re-index it.
Claim this page
Sign in with GitHub and we check that you are an admin or maintainer of heymrun/heym. Then add a badge to the README that links readers here.
Add a badge to your README
Readers click through to this page and can ask heym's code a question. A badge also re-indexes the repo every week and marks you as the verified maintainer.
[](https://repowise.dev/repo/heymrun/heym?src=badge_ask)Paste it at the top of README.md, under the title.
Added it already? Verify to get the mark now instead of tomorrow.
Need HTML or the larger health card? More formatsHide more formats
This badge as HTML
<a href="https://repowise.dev/repo/heymrun/heym?src=badge_ask"><img src="https://api.repowise.dev/badge/wiki/heymrun/heym.svg?label=ask" alt="repowise: Ask this codebase"></a>Code health card
The score, its change since the last index, and when it was measured. Follows the reader's light or dark theme.
<a href="https://repowise.dev/repo/heymrun/heym?src=badge_card"><picture><source media="(prefers-color-scheme: light)" srcset="https://api.repowise.dev/badge/health/heymrun/heym.svg?style=card&theme=light"><img src="https://api.repowise.dev/badge/health/heymrun/heym.svg?style=card" alt="repowise code health" width="500" height="168"></picture></a>