Hex Connect Agent for Windows and Mac

What it does
Hex Connect Agent pairs a trusted local computer with a Hexcore Flow workspace. It reports heartbeat, shares configured local-printer telemetry, receives approved workspace requests, and can send supported pause, resume, and cancel requests to locally configured OctoPrint or Moonraker printers when control is enabled for that printer.

Supported in this package
- Windows launch scripts
- Mac launch scripts
- Pairing with Hexcore Flow
- Local printer setup stored on the computer running Hex Connect
- Status reads for OctoPrint and Moonraker
- Live telemetry reporting for printer state, progress, temperatures, and ETA when available
- Pause, resume, and cancel for OctoPrint and Moonraker when enabled locally
- Assignment/status reporting for manual and handoff-style printers

Setup on Windows
1. Install Python 3.10 or newer for Windows.
2. Unzip this folder.
3. Run configure-printers.bat to add local printer connections.
4. Log in to Hexcore Flow.
5. Open Account > Hex Connect or the Hex Connect section in the app.
6. Choose Pair Hex Connect and copy the six-digit pairing code.
7. Run pair-hex-connect.bat and enter the URL and pairing code.
8. Run start-hex-connect.bat when this computer should check in.

Setup on Mac
1. Install Python 3 if it is not already available.
2. Unzip this folder.
3. Control-click configure-printers.command and choose Open.
4. Add the local printer connections this Mac can reach.
5. Log in to Hexcore Flow.
6. Open Account > Hex Connect or the Hex Connect section in the app.
7. Choose Pair Hex Connect and copy the six-digit pairing code.
8. Control-click pair-hex-connect.command and choose Open.
9. Control-click start-hex-connect.command and choose Open when this Mac should check in.

Printer control safety
Printer control is disabled by default for each printer. Enable it only for printers and connection methods you trust. Hex Connect does not bypass printer safety controls. Pause, resume, and cancel requests are sent through the local OctoPrint or Moonraker connection configured on the same computer.

Partner farm use
A partner farm must run and pair its own Hex Connect agent from a computer that can reach its printers. Printer requests only work when that local connector is paired, the printer is assigned, and control is enabled for that printer.

Local storage
The agent stores its pairing token and local printer connection settings in the current user's app data folder:
- Windows: %APPDATA%\HexConnect
- Mac: ~/.hexconnect

Support
Email support@hexcoreflow.com for setup help.
