Skip to content

MiderHive 1.0.2

Choose a tag to compare

View all tags
@SiliconCoderJames SiliconCoderJames released this 12 Sep 06:02
· 122 commits to master since this release
V1.0.2
14f7760

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.

Brand note: this is the first release under the new name MiderHive (renamed from
AgentHive to avoid clashes with unrelated projects). Same product, same data, same pipeline —
the executable, environment variables and data directory simply follow the new brand. Old
AGENTHIVE_* / ZCODE_* names and the old data directory are recognised and migrated
automatically.

⚠️ 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.2-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.2-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.2-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 AgentHive 1.0.x or 1.0.0/1.0.1: just install this MSI over the old one — it uses the
    same upgrade identity, so the old version is removed first and nothing is left behind. Your
    data directory (%USERPROFILE%\.agenthive) is renamed to %USERPROFILE%\.miderhive
    automatically on first run    ; knowledge, messages, memory and agent keys all carry over, and
    installing/uninstalling never deletes it.
  • Settings carry over too: theme, font size, window geometry and update preferences are
    migrated to the new settings location on first run.
  • 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 (unified response envelope, error codes, task state machine, examples) is 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.2-x64.msi             -Algorithm SHA256
Get-FileHash .\MiderHive-1.0.2-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

Brand rename (the change)

  • The project is now MiderHive: the workbench executable is miderhive.exe, the update
    channel, installer and repository URLs follow the new name. /api/health now reports
    "service": "miderhive".
  • Everything else behaves exactly like 1.0.1 — no schema changes, no protocol changes, no
    functional regressions introduced by the rename. All 243 unit-test assertions and the 39-assertion
    HTTP integration suite pass on this build.

Compatibility (kept on purpose)

  • Old AGENTHIVE_* / ZCODE_* environment variables and the old %USERPROFILE%\.agenthive
    data directory keep working and are migrated automatically.
  • Installing over an existing AgentHive 1.0.x upgrade-in-place removes the old version cleanly.

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 请求就能入巢。

  • 品牌更名：本项目更名为 MiderHive（原 AgentHive，避免与已有项目重名）。主程序为
    miderhive.exe，更新通道与仓库地址随之更新；/api/health 自报 "service": "miderhive"。
    除更名外与 1.0.1 功能完全一致（243 项单元断言 + 39 项 HTTP 集成断言全绿）。
  • 下载哪个：MiderHive-1.0.2-x64.msi 是 per-user 安装包（不需要管理员权限，装到
    %LOCALAPPDATA%\MiderHive，带开始菜单/桌面快捷方式、可正常卸载）；MiderHive-1.0.2-win64-portable.zip
    免安装，解压后运行 miderhive.exe；SHA256SUMS.txt 用于校验。
  • 从旧版升级：直接覆盖安装即可（同一升级标识，旧版先卸载）；%USERPROFILE%\.agenthive
    数据目录会在首次运行时自动改名为 %USERPROFILE%\.miderhive，主题/字号/窗口几何等设置
    一并迁移；已注册的 Agent 继续可用，密钥丢失到 设置 → Agent → 重新生成密钥 补发。环境变量
    新名为 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 7
Loading