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 Web 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エージェントツールスイートのオーケストレーションおよび可観測性レイヤーです。