nullclaw/nullhub

NullHub – 用于 NullClaw AI 代理生态系统的本地管理中心

它是什么

• 一个使用 Zig 编写的单二进制应用程序，内置 Svelte 网页界面。它作为 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 的遥测可视化。

如何使用

# 构建二进制文件（需要 Zig 和 npm 来处理 UI）
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 与单一来源通讯。

谁会觉得它有用？

• 使用 NullClaw 构建或测试 AI 代理管线，且需要本地、可重现环境的开发人员。
• 尝试工作流编排 (NullBoiler) 和跟踪分析 (NullWatch) 而不依赖云服务的研究人员。
• 需要简单方法来启动多个隔离实例以进行 CI 或演示的团队。

运行需求

• Zig 0.16 (编译器) 和 npm (用于构建 Svelte UI)。二进制文件可以通过常见的包管理器自动安装缺失的系统工具。
• 基本 Unix 工具 (curl, tar)。在 Windows 上，它将尝试使用 winget/choco。

开发与测试

• 单元测试和集成测试使用 zig build test … 运行。
• UI 开发：cd ui && npm run dev。
• tests/ 下的端对端脚本验证完整的安装-运行-监控周期。

---

NullHub 本身不是机器学习模型；它是 NullClaw AI 代理工具套件的编排和可观测性层。