Hivemill

Operator guide / Installation

Install the
factory.

Set up Hivemill on a separate Debian or Ubuntu host. Start with the prerequisites, then run guided setup inside Claude Code.

Check the prerequisites

Inside Claude Code

  1. Add the marketplace

    /plugin marketplace add volekerb/hivemill
  2. Install the plugin

    /plugin install hivemill
  3. Run guided setup

    /hivemill:setup

Prerequisites

Prepare the host.

Linux machine
Use a separate Debian or Ubuntu machine that can stay on while your laptop is closed. The factory runtime needs Python 3.11 or newer.
Claude Code
Sign in on the factory machine. Claude Code uses its model provider; self-hosting the factory does not move model inference onto your host.
GitHub access
Sign in to the GitHub CLI with access to the repository where the factory will open pull requests.
Optional runtimes
Cursor Agent CLI supports the Cursor organization and the daily retro agent. A Mac can watch the Linux factory through the Herdr desktop app.

Guided setup

Bring up the factory.

Run the three commands above in a logged-in Claude Code session on the host. The setup skill guides installation and starts the first agents.

For manual installation, host services and configuration, use the full setup guide.

Read the full setup guide

Verification

Inspect the install.

From a checkout of the Hivemill repository, run this read-only check in your own terminal. The report shows which prerequisites the installer sees.

plugins/hivemill/scripts/install --check

To preview the installer’s ordered plan before applying it, run the dry run from the same checkout.

plugins/hivemill/scripts/install --dry-run