HELM AI Kernel
AI 에이전트를 위한 실패 시 폐쇄(Fail-closed) 실행 방화벽.
HELM은 Claude Code, Codex, MCP 도구, 셸 명령어 및 기타 에이전트 액션 사이에 위치합니다. HELM은 ALLOW, DENY, 또는 ESCALATE를 결정하고, 나중에 검증할 수 있는 서명된 영수증(signed receipt)을 작성합니다. 검증 과정은 서명의 무결성(signature integrity)을 즉시 확인하며, 누가 서명했는지에 대한 신뢰는 별도의 명시적 단계입니다 — 로컬 서명자 및 신뢰할 수 있는 검증을 참조하십시오.
HELM AI Kernel: one boundary, one decision, one receipt
사용해 보기 (Try It)
brew install mindburn-labs/tap/helm-ai-kernel
helm-ai-kernel
...
완전한 자격 증명(fully qualified) Homebrew 설치는 tap을 추가하고 이 포뮬러만을 신뢰합니다. Homebrew Tap Trust를 참조하십시오.
에이전트에게 위험한 작업을 수행하도록 요청해 보십시오. HELM은 해당 작업이 실행되기 전에 액션을 차단하거나 에스컬레이션시키고, 그 결정을 기록합니다.
helm-ai-kernel workstation verify-decision \
--receipt ~/.helm-ai-kernel/receipts/hooks/<decision>.json
이것은 영수증이 변경되지 않았음(integrity_valid)을 증명합니다. 서명자 신뢰(signer trust)는 별도의 판결문(signer_trusted)이며, 예상되는 워크스테이션 공개 키와 비교됩니다 — 기본값은 로컬 --data-dir에 있는 키입니다. 다른 장치에서 복사된 영수증의 경우, --trusted-public-key-file을 사용하여 오프라인으로 서명자의 키를 지정해야 합니다. 레거시 파생 시드(security patch line에서 폐지됨)로 서명된 영수증은 항상 신뢰할 수 없습니다.
클라우드 계정 없음. 모델 키 없음. Docker 없음. 프로덕션 자격 증명 없음.
보안 모델 (요약)
기본적으로 실패 시 폐쇄(Fail-closed): 알 수 없는 도구는 전송 전에 에스컬레이션하거나 거부합니다; 서명된 영수증은 판결문을 증명하며, EvidencePacks는 오프라인에서 검증합니다. HELM은 호스트 OS 격리, 비밀 스캐닝 또는 네트워크 방화벽을 대체하지 않으며, HELM 어댑터, 훅(hook), 래퍼(wrapper), 프록시 또는 API 경로를 가로지르는 효과만을 관리합니다. 전체 모델: Execution security model.
운영자 TUI(Text User Interface)에서의 절차는 APPROVE 또는 DENY를 입력해야 합니다. 카탈로그는 설정 편의성 이전에 Doctor, Watch, Policy, Freeze, Threat 순서로 등급을 매깁니다. 로컬 mcp approve는 MCP 권한을 발행(mint)하지 않습니다. 우회 경로는 다음과 같습니다: HELM_NO_TUI=1, TERM=dumb, 파이프. 자세한 내용은 CLI I/O Convention를 참조하십시오.
기능 설명 (What It Does)
| 에이전트가 시도하는 것... | HELM의 동작 | 증명 (Proof) |
|---|
| 파괴적인 셸 명령어 실행¹ | DENY | 서명된 영수증 (signed receipt) |
| ... | | |
¹ 로컬 에이전트 후크는 강제되는 경계(enforced boundary)가 아닌 관찰 전용 통합(observed-only integration)입니다. 이 셸 가드는 의도적으로 좁게 설정된 파괴적 명령어 패턴을 일치시키고 정적으로 평가할 수 없는 구문을 거부하며, 일반적인 셸 분석기는 아닙니다. 가드의 범위를 참조하십시오.
HELM은 자신의 경계에 도달하는 효과(effects)만을 관리합니다. 예를 들어, 에이전트가 실제로 LAN 또는 허용 목록에 없는 HTTPS 요청을 전송했을 때 네트워크 외부 송신 차단(network egress blocks)이 작동했음이 평가를 통해 확인되었습니다. 프롬프트만 조작하거나 모델이 거부하는 경우, 또는 도구 호출을 시도하지 않는 에이전트의 경우에는 HELM 외에도 모델, 앱 및 샌드박스 제어(sandbox controls)가 필요합니다.
예시 (One Example)
에이전트 요청: 프로덕션 데이터베이스 삭제
HELM 감지: 보호된 데이터 + 되돌릴 수 없는 행동
HELM 응답: DENY
...
다음 단계 (Where To Go Next)
이것이 아닌 것 (What It Is Not)
- Kubernetes Helm이 아닙니다.
- 호스팅되는 HELM Enterprise 제품도 아닙니다.
- HELM Company Builder, Company OS, 또는 HELM Network도 아닙니다. 이들은 이 경계를 중심으로 하는 목표 상업적 경험(target commercial experiences)이며, 커널 기능이나 일반 사용 가능성 증거가 아닙니다.
- 앱 생성기, 파운데이션 모델, 소셜 네트워크, 은행, 에스크로 서비스, 결제 레일, 또는 총계정원장(general ledger)도 아닙니다. 사용자는 호환 가능한 모든 외부 도구로 구축하고 그 결과적인 행동들을 이 경계를 통해 라우팅할 수 있습니다.
- 모호한 AI 안전 주장도 아닙니다.
이것은 오픈 소스 실행 경계입니다: 정책 입력(policy in), 액션 검증(action checked), 영수증 출력(receipt out).
영구 무료 (Free Forever)
오픈 소스 커널은 트라이얼 버전이 아닌 완전한 경계입니다:
- 로컬 실행 경계(local execution boundary) — 판결(verdicts), 서명된 영수증(signed receipts), 오프라인 검증(offline verification) — 은 영구적으로 무료입니다.
- 자체 키 가져오기(BYOK, Bring Your Own Keys): BYOK와 셀프 호스팅(self-hosting)은 결코 유료화되지 않습니다.
- 상용 제품들은 경계 주변의 조직적 계층(organizational layer)입니다 (호스팅된 보존, 팀 제어 평면(team control plane), 인증). 절대 그 자체가 아닙니다.
기여는 Apache-2.0(CONTRIBUTING.md)을 따릅니다. 이름 및 로고 사용은 TRADEMARK.md에서 다룹니다.
소스 빌드 (Source Build)
소스 빌드는 Go 1.26.10(go.work 및 mise.toml에 의해 고정된 버전)을 사용합니다. 지원되는 재현 가능한 레시피는 체크아웃된 mise 구성을 명시적으로 신뢰하고 고정된 툴체인(toolchain)을 설치합니다. mise를 사용할 수 없는 경우, 대신 호환되는 네이티브 Go 툴체인을 사용하십시오.
git clone https://github.com/Mindburn-Labs/helm-ai-kernel.git
cd helm-ai-kernel
git checkout v0.11.3
...
Quickstart 배포 매트릭스에는 릴리스된 바이너리(binaries), 컨테이너 이미지(container images), OCI 차트, 릴리스 전용 MCPB 및 콘솔 번들, 그리고 SDK 패키지 표면이 나열되어 있습니다. SDK는 커널 실행 파일 설치가 아닌 클라이언트 라이브러리입니다.
프로젝트 (Project)
| Release target | SDK pointers after publication |
|---|
v0.11.3 | github.com/Mindburn-Labs/helm-ai-kernel/sdk/[email protected] |
v0.11.3 | io.github.mindburnlabs:helm-sdk:0.11.3 |
Apache-2.0. LICENSE, SECURITY.md, 및 CONTRIBUTING.md를 참조하십시오.
HELM의 역할 (Where HELM Fits)
예시는 설명용입니다. HELM은 에이전트(agent), 오케스트레이터(orchestrator), 클라우드 제어 평면(cloud control plane) 또는 관측 가능성 도구(observability tool)가 아닌 실행 경계 자체입니다.
| Category | Examples | What They Do | Where They Stop | HELM AI Kernel |
|---|
| 에이전트 권한 모드 (Agent permission modes) | Claude Code Auto Mode | 에이전트가 더 적은 프롬프트로 빠르게 작업하도록 합니다. | 권한 자동화는 실행 거버넌스(execution governance)가 아닙니다. | HELM은 모든 통제되는 액션이 판결(verdict)과 증거(proof)를 생성하도록 만듭니다. |
| ... | | | | |
| 요약하자면: 대부분의 도구는 에이전트가 행동하도록 돕습니다. HELM은 해당 액션이 허용되는지 결정하고, 그렇지 않을 경우 차단하며, 외부 검토자가 확인할 수 있는 증거를 남깁니다. | | | | |
