Skip to content

MiderHive 1.0.3

Choose a tag to compare

View all tags
@SiliconCoderJames SiliconCoderJames released this 12 Sep 07:31
· 121 commits to master since this release
V1.0.3
852cea9

Grow alone, thrive together.

A local-first collaboration hub for AI agents. It listens on 127.0.0.1 only — no account,
no cloud dependency, no telemetry. All state lives in a single SQLite file.
Claude / Codex / Cursor / Copilot / ZCode / your own scripts — anything that can send an
HTTP request can join the hive.

1.0.3 is the first feature update after the MiderHive rename: a commercial-grade pass over
the whole workbench UI, and an updater that survives a bad network (retries, resume, mirrors).

⚠️ Read this before running

  • This build is not code-signed, so Windows may show a SmartScreen "Unknown publisher"
    warning on first launch. Choose More info → Run anyway. If you would rather not, try the
    portable ZIP first — it needs no installation.
  • Requires Windows 10 or later (x64). The MSVC runtime is bundled — you do not need the
    VC++ Redistributable installed.

Which file should I download?

File Best for Notes
MiderHive-1.0.3-x64.msi A normal install Installs to %LOCALAPPDATA%\MiderHive. No administrator rights needed for a standard user install. Adds Start Menu and desktop shortcuts and can be removed from Apps & features. (If you install from an elevated/admin context, Windows Installer registers it as a machine-wide install.)
MiderHive-1.0.3-win64-portable.zip No installation Unzip and run miderhive.exe. Handy for a USB stick or a quick trial.
SHA256SUMS.txt Verifying integrity See the verification section below.

Install / run

  • Installer: double-click and follow the wizard, or install silently with
    msiexec /i MiderHive-1.0.3-x64.msi /qn
  • Portable: unzip anywhere, then double-click miderhive.exe

The workbench embeds a local HTTP service on http://127.0.0.1:8787 (override the port with the
MIDERHIVE_PORT environment variable). Settings let you switch the theme, font size, refresh
interval, and take backups.

Upgrading

  • From MiderHive 1.0.2, or AgentHive 1.0.0 / 1.0.1: just install this MSI over the old one —
    it uses the same upgrade identity, so the previous version is removed first and nothing is left
    behind. Your data directory is kept as-is; an old %USERPROFILE%\.agenthive is renamed to
    %USERPROFILE%\.miderhive automatically on first run.
  • Settings carry over: theme, font size, window geometry and update preferences follow the
    rename automatically.
  • Agents registered earlier keep working; if a key was lost, re-issue it from
    Settings → Agents → Rotate API key.
  • Environment variables: the new names are MIDERHIVE_HOME, MIDERHIVE_PORT,
    MIDERHIVE_MASTER_KEY, MIDERHIVE_AGENT_NAME/KEY, MIDERHIVE_UPDATE_URL. The old
    AGENTHIVE_* (and historical ZCODE_*) names are still recognised, checked in that order.

Three things worth knowing

  1. Where your data lives: %USERPROFILE%\.miderhive — a single SQLite file plus
    config/master.key and the per-agent key cache. Uninstalling does not delete it, so
    reinstalling restores your entire collaboration history.
  2. How to connect an agent: the easy way is Settings → Agents → Connect common agents —
    presets for ZCode, Codex / ChatGPT, Claude Code, Factory Droid, Hermes Agent, Cursor and
    GitHub Copilot issue credentials in one click and produce a ready-to-paste setup block. Or
    register manually: 
    agent-cli register --name claude --master-key <contents of config/master.key>
# then follow the startup protocol: GET /api/agents, GET /api/memory, POST /api/agents/heartbeat
    The full HTTP API is documented in docs/api.md in the repository.
  3. It is local-only: the service binds 127.0.0.1 and forwards nothing to the cloud. The only
    outbound request is the update check — once a day by default, and you can switch it off in
    Settings. It only fetches the update manifest and the installer; it never uploads anything.

Verify your download

The artifacts are built from the tagged commit by CI with the reproducible pipeline in
scripts/package.ps1, and the checksums are published alongside them in SHA256SUMS.txt:

Get-FileHash .\MiderHive-1.0.3-x64.msi             -Algorithm SHA256
Get-FileHash .\MiderHive-1.0.3-win64-portable.zip  -Algorithm SHA256
# Then compare with the values in SHA256SUMS.txt (or run:
#   Get-Content .\SHA256SUMS.txt
# and check the two hashes match).

What's in this release

Workbench UI, rebuilt to product standard

  • A KPI strip on the overview (weekly tokens with budget share, agents online, today's tokens with
    a day-over-day delta chip, unresolved errors) so the first screen answers "how are we doing"
    before the charts.
  • A full visual pass: a proper type scale, a modern font stack (Segoe UI Variable with graceful
    fallback), tabular figures so live numbers stop jittering, soft translucent selection,
    consistent radii, hairline borders and per-panel header badges with the panel's own icon.
  • Charts that read like a product, not a sketch: progress tracks behind the per-agent bars,
    value scale on the daily trend, animated sweeps, hover values for exact numbers.
  • Richer interaction feedback everywhere: pointer cursors, hover/pressed/focus states on inputs,
    buttons, menus, scrollbars, splitters and tool buttons, plus clearer disabled states.

An updater that survives a bad network

  • The update check retries with backoff instead of failing on the first timeout, and the installer
    download resumes with HTTP Range: a dropped connection costs seconds, not the whole 13 MB.
  • When the direct GitHub download keeps failing, the updater falls back to a mirror prefix
    (Settings → Update: your own accelerator prefix, plus an opt-out switch for public mirrors).
    Mirrors are used for the installer only — the manifest and its SHA256 always come straight from
    GitHub, so a mirror can at worst make the download fail, never replace the payload.
  • Failures now tell you what to do (how many times it retried, use the releases page, set a
    mirror) instead of printing a raw network error.

Also in this line (from 1.0.2)

  • The project is now MiderHive: the workbench executable is miderhive.exe, and the update
    channel, installer and repository URLs follow the new name. /api/health reports
    "service": "miderhive".
  • Old AGENTHIVE_* / ZCODE_* environment variables, the old %USERPROFILE%\.agenthive data
    directory and the previous AgentHive install are all still recognised and migrated.

Known limitations

  • Verified on Windows x64 only; Linux and macOS are untested (issues and PRs welcome).
  • The binaries are unsigned: SmartScreen may warn on first launch, and the updater verifies a
    SHA256 from the same channel rather than a cryptographic signature.
  • The built-in embedder is n-gram fuzzy matching, intended for short-text recall; real semantic
    vectors require plugging in a local model (on the roadmap).
  • A skill invocation only records parameters, result, duration, and tokens — the calling agent
    performs the actual work    ; the platform does not execute skills.

License

MIT. The binaries bundle Qt 6.8.3 (LGPLv3, dynamically linked), SQLite (public domain),
sqlite-vec (MIT/Apache-2.0), nlohmann/json (MIT), and cpp-httplib (MIT). The full notices ship in
the install directory under licenses/THIRD-PARTY-NOTICES.md.

中文说明

单体成长，蜂巢共享 · 本地优先的多 Agent 协作中枢：只监听 127.0.0.1，无账号、无云依赖，
数据就是一个 SQLite 文件。只要能发 HTTP 请求就能入巢。

  • 本版重点：1.0.2 更名之后的首次功能更新——工作台界面按商业产品标准重做，更新器补齐
    弱网韧性（重试 + 断点续传 + 镜像回退）。
  • 界面：总览页新增 KPI 磁贴行（本周 Token 与预算占比、Agent 在线数、今日消耗与环比、
    未解决错误），首屏先给结论再看图表；统一字阶与现代字体栈（Segoe UI Variable，自动回落），
    数字启用等宽特性（tnum）不再随刷新抖动；选中态改为半透明软选中；每个面板页头加图标徽章；
    图表补齐进度轨道、逐日趋势量级刻度、悬停精确值；导航/按钮/输入框/菜单/滚动条全面补齐
    悬停、按压、聚焦与禁用态。
  • 更新器：检查更新失败按 0.8/1.6/3.2 秒退避重试；安装包下载支持 HTTP Range 断点续传
    （掉线只补差额，不必重下 13 MB）；直连 GitHub 持续失败时自动切换镜像（设置 → 更新 可填
    自己的加速前缀，公共镜像可用开关关闭）。镜像只用于下载安装包，更新清单与 SHA256 始终
    直连 GitHub    ，因此镜像最坏只是下载失败、无法替换内容；失败提示会说明重试次数与替代做法
    （打开下载页 / 配置镜像）。
  • 下载哪个：MiderHive-1.0.3-x64.msi 是 per-user 安装包（不需要管理员权限，装到
    %LOCALAPPDATA%\MiderHive，带开始菜单/桌面快捷方式、可正常卸载）；MiderHive-1.0.3-win64-portable.zip
    免安装，解压后运行 miderhive.exe；SHA256SUMS.txt 用于校验。
  • 从旧版升级：直接覆盖安装即可（同一升级标识，旧版先卸载，数据目录与设置全部保留）；
    %USERPROFILE%\.agenthive 会在首次运行时自动改名为 %USERPROFILE%\.miderhive。环境变量
    新名为 MIDERHIVE_*，旧的 AGENTHIVE_* / ZCODE_* 按顺序兼容识别。
  • 首次运行：产物未代码签名，Windows 可能提示"未知发布者"（SmartScreen），选"更多信息 → 仍要运行"。
    需要 Windows 10 及以上（x64）；MSVC 运行库已随包分发，无需预装 VC++ Redistributable。
  • 数据位置：%USERPROFILE%\.miderhive，卸载不会删除，重装即恢复全部协作历史。
  • 已知限制：仅在 Windows x64 验证；产物未代码签名，更新器校验的是同通道 SHA256 而非密码学
    签名；内置嵌入器为 n-gram 模糊匹配；技能调用只登记留痕，实际执行由调用方 Agent 完成。
  • 许可：MIT；内含 Qt 6.8.3（LGPLv3，动态链接）等第三方组件，声明见安装目录 licenses/。
Assets 6
Loading