왜 나는 n8n을 확장하는 대신 Heym을 만들었는가
Source: Dev.to
Heym은 자체‑호스팅이 가능한, 소스‑코드 공개 AI 워크플로 자동화 플랫폼입니다. 에이전트, 검색, 승인 단계, 가시성, 스케줄링, 그리고 워크플로를 AI 어시스턴트를 위한 호출 가능한 도구로 노출할 수 있는 단일 런타임을 제공합니다. Docker Compose를 통해 자체 인프라에서 실행되므로 데이터가 스택을 떠나지 않습니다.
Heym이 실제로 무엇인지
Heym은 에이전트가 추론하고, 도구를 호출하고, 문서를 검색하며, 인간 검토를 위해 일시 중지할 수 있는 통합 환경을 제공합니다—모두 같은 실행 흐름 안에서 이루어집니다. n8n, Zapier, Make와 같은 결정론적 자동화 플랫폼과 달리 AI‑네이티브 워크플로에 특화되어 설계되었습니다.
실행 모델
워크플로 엔진은 캔버스에서 방향성 비순환 그래프(DAG)를 구축하고, 스레드 풀을 사용해 독립 노드를 동시에 실행합니다. 스트리밍 모드에서는 각 노드가 완료될 때마다 이벤트가 방출되어 프론트엔드가 실시간으로 업데이트됩니다.
- 에이전트 노드는 전체 도구‑호출 루프를 지원합니다: 파이썬 도구 실행, 외부 MCP 서버 연결, 서브‑에이전트 위임, 다른 워크플로를 도구로 호출 등.
- 컨텍스트 사용량이 모델 윈도우의 80 %에 접근하면, 엔진이 자동으로 히스토리를 압축해 장시간 실행되는 에이전트가 작업 중에 조용히 실패하는 것을 방지합니다.
Human‑in‑the‑Loop을 일급 원시값으로
AI 출력은 실제 영향을 미칠 수 있습니다(예: 초안 이메일, 생성 보고서, 데이터 변환). HITL 노드는 실행을 어느 시점에서든 일시 중지하고, 공개 일회성 검토 URL을 생성한 뒤 대기합니다. 검토자는 다음을 할 수 있습니다:
- 출력을 승인
- 수정
- 거부
Heym 계정이 없어도 가능합니다. 검토가 끝나면 정확히 저장된 스냅샷에서 실행이 재개되며, 동일한 실행이 여러 번 일시 중지될 수 있습니다. 이는 우회책이 아니라 핵심 워크플로 설계 원시값입니다.
내장된 지식 검색
문서 검색은 별도의 외부 서비스가 아니라 런타임에 내장되어 있습니다. Heym은 내장 벡터 스토어 관리를 제공합니다:
- 문서 업로드
- 스토어 생성
- 의미 검색을 워크플로에 직접 연결
전체 파이프라인이 단일 워크플로 안에서 실행되고 통합 트레이스로 표시되어 별도 시스템 및 디버깅 컨텍스트가 필요 없습니다.
MCP 서버
모든 Heym 인스턴스는 내장 MCP 서버를 실행합니다. 만든 워크플로는 Claude Desktop, Cursor, 혹은 any MCP 클라이언트가 직접 호출할 수 있는 도구로 노출될 수 있습니다. 에이전트 노드도 외부 MCP 서버에 도구 소스로 연결할 수 있어 양방향 기능 흐름을 가능하게 합니다.
가시성
- Traces 탭: 모든 실행을 자동으로 로그합니다.
- Evals 탭: 테스트 스위트를 만들고, 여러 모델에 대해 동시에 평가를 실행하며, 점수를 구성 가능하게 합니다.
가시성은 플랫폼에 기본적으로 포함된 기능이며, 사후에 추가되는 것이 아닙니다.
스택
- 프론트엔드: Vue 3 + TypeScript, Vue Flow
- 백엔드: Python, FastAPI, async SQLAlchemy
- 데이터베이스: PostgreSQL 16
- 배포: Docker Compose 스택
현재 상황
Heym은 v0.0.1 버전이며 활발히 개발 중입니다. 소스 코드는 MIT 라이선스와 Commons Clause 하에 제공됩니다.
AI 워크플로를 구축하면서 문제 자체보다 접착 코드에 더 많은 시간을 쓰고 있다면, Heym을 한 번 사용해 보세요.
GitHub:
