repowiserepowise

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.

★ 1,671stars on GitHubPython

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
heym facts
TypeMCP server
Code health6.6 / 10 (Fair)
Health rank#168 of 4,000+ indexed repos
Last commitOct 1, 2026
Contributors28
Bus factor1
Size1,643 files, 294,386 lines

Install heym

Commands copied from the README

  1. 1Clone the heym repository.
    git clone https://github.com/heymrun/heym.git
  2. 2Enter the repository directory
    cd heym
  3. 3Optionally create a .env file from the example file
    cp .env.example .env

Releases on GitHub (latest v0.0.165, Nov 20, 2026)

Full install notes on GitHub

Explore heym

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

6.6out of 10Fair

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.