Architecture of heymrun/heym
heymrun/heym is 1,643 source files holding 20,286 symbols across 5 modules, written mainly in Python, Vue, TypeScript. The largest module is backend, with 786 files, and 3 files are entry points into the dependency graph.
How heym fits together
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.
Largest modules
- backend: 786 files and 186,943 lines of code
- frontend: 565 files and 106,150 lines of code
- root: 6 files and 799 lines of code
- docker: 3 files and 450 lines of code
- scripts: 2 files and 44 lines of code
Languages
By file count: Python 786 files, Vue 312 files, TypeScript 248 files, Shell 10 files, JavaScript 4 files, Dockerfile 2 files.
Documentation
Repowise documents heym in 1,859 pages generated from the source, 40 of them written explanations of the repository and its modules. Module guides include:
- frontend/src/features/assistant-yolo: AI Assistant Yolo Flow
- backend/app/services/alerts: Alerts Subsystem
- frontend/src/components/Alerts: Alerts UI Components
More on heym: summary and FAQ, codebase overview, code health.
Related guide: Best dependency graph tools for monorepos