nullclaw/nullhub

Management console for the Null ecosystem — install, configure, and monitor AI agents, orchestration workflows, task pipelines, and system health

NullHub – NullClaw AI 에이전트 생태계를 위한 로컬 관리 허브

개요

Zig로 작성된 단일 바이너리 애플리케이션으로, Svelte 웹 UI를 번들로 제공합니다. 이는 AI 에이전트 구성 요소 제품군(NullClaw, NullBoiler, NullTickets, NullWatch)의 제어 평면 역할을 합니다.
가볍고 자체 호스팅되는 "Docker-Compose와 유사한" 관리자라고 생각하면 되지만, NullClaw 생태계에 특화되어 있습니다. 각 구성 요소를 설치, 시작, 중지, 모니터링 및 업데이트할 수 있으며 자동화를 위한 REST/CLI API를 노출합니다.

주요 기능

기능	내용
설치 마법사	구성 요소 간의 종속성(예: NullTickets를 NullBoiler에 연결)을 인식하는 매니페스트 기반의 가이드 설정.
프로세스 감독	구성 요소를 시작하고, 충돌 시 지수 백오프를 통해 재시작하며, HTTP 체크를 통해 상태를 추적합니다.
상태 대시보드	각 인스턴스에 대한 실시간 상태 카드 및 로그 스트리밍 (SSE).
구성 요소 간 연결	NullTickets가 NullBoiler와 통신하고, NullWatch가 실행을 시각화할 수 있도록 구성을 자동 생성합니다.
구성 편집기	각 구성 요소의 JSON 구성을 위한 구조화된 UI 및 원시 JSON 폴백.
원클릭 업데이트	새 릴리스 다운로드, 구성 마이그레이션 및 실패 시 롤백 기능.
다중 인스턴스 지원	동일한 구성 요소의 독립적인 복사본을 여러 개 나란히 실행.
CLI + Web UI	사용자 친화적인 브라우저 UI 및 스크립트용 풀 기능 명령줄 인터페이스.
미션 컨트롤	로컬 "에이전트 미션 리플레이" 샌드박스: 외부 모델 API 없이 결정론적 실패 복구 시나리오 리플레이, 체크포인트 포크 및 원격 측정 시각화.

사용 방법

# 바이너리 빌드 (UI를 위해 Zig와 npm 필요)
zig build
# 실행 – 서버가 시작되고 브라우저에서 UI가 열립니다
./zig-out/bin/nullhub

UI는 http://nullhub.localhost:19800 (또는 127.0.0.1)에서 제공됩니다. 거기에서 Null* 구성 요소를 설치하고, 시작하고, 로그를 보고, 미션 컨트롤 리플레이 화면을 탐색할 수 있습니다.

아키텍처 개요

백엔드 (Zig) – HTTP 서버, 프로세스 감독자, 설치 프로그램 및 각 구성 요소와 함께 제공되는 nullhub-manifest.json 파일을 읽는 매니페스트 엔진.
프론트엔드 (SvelteKit) – 정적 자산으로 컴파일되어 Zig의 @embedFile을 통해 바이너리에 포함됩니다. UI 모듈은 필요에 따라 로드됩니다.
상태 저장소 – 모든 구성, 바이너리, 로그 및 리플레이 아티팩트는 ~/.nullhub/ 아래에 저장됩니다.
프록시 – NullHub는 API 호출을 실제 구성 요소 서비스(NullBoiler, NullTickets, NullWatch)로 전달하므로 UI는 단일 오리진과 통신합니다.

대상 사용자

실행 요구 사항

Zig 0.16 (컴파일러) 및 npm (Svelte UI 빌드용). 바이너리는 일반적인 패키지 관리자를 통해 누락된 시스템 도구를 자동으로 설치하려고 시도합니다.
기본적인 Unix 도구 (curl, tar). Windows에서는 winget/choco를 사용하려고 시도합니다.

개발 및 테스트

NullHub 자체는 머신러닝 모델이 아닙니다. NullClaw AI 에이전트 도구 모음을 위한 오케스트레이션 및 관측 가능성 계층입니다.