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 prerequisitesInside Claude Code
-
Add the marketplace
/plugin marketplace add volekerb/hivemill -
Install the plugin
/plugin install hivemill -
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 guideVerification
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