Create install script for Hero Compute and required binaries

mahmoud commented

2026-04-06 10:09:23 +00:00

Owner

Description

A script to install all required binaries from release pages and move them to the appropriate path. Think of it like:

curl --proto '=https' --tlsv1.2 -sSf https://forge.ourworld.tf/lhumina_code/hero_compute/scripts/install.sh | sh

The script should:

Install the latest stable version of hero_proc from:
https://forge.ourworld.tf/lhumina_code/hero_proc/releases
Install the latest stable version of mycelium from:
https://github.com/threefoldtech/mycelium/releases
Install the latest stable version of my_hypervisor from:
https://forge.ourworld.tf/geomind_code/my_hypervisor/releases
Install the latest stable version of cloud-hypervisor from:
https://github.com/cloud-hypervisor/cloud-hypervisor/releases/
Download all required binaries for hero_compute from:
https://forge.ourworld.tf/lhumina_code/hero_compute/releases

Post-installation steps:

Make all downloaded files executable
Rename them to match their repository names
Move them to the Hero binary path

Note:
The binaries should be moved to the Hero path (~/hero/bin) — not the system path.
No changes should be made to the user's system PATH.

System dependencies:

After installing all binaries:

Check for required system dependencies
If any are missing, install them automatically

Service setup:

After confirming that all binaries and dependencies are installed:

Start required services (e.g., hero_proc, mycelium) in the background using the central config peers
Print the next steps for the user, for example:
```
hero_compute start --mode master
```

User confirmation:

Before starting the installation, the script should:

Clearly print all planned actions
Ask for user confirmation

Example:

Some system dependencies are missing. You can either allow us to install them, or exit and install them manually.

System packages to install:
  - iproute2
  - net-tools

Binaries to install:
  - mycelium
  - hero_proc
  - my_hypervisor

Services that will run in the background:
  - mycelium
  - hero_proc

All binaries will be moved to: ~/hero/bin

Do you want to continue? (y/n)

Final output:

After installation completes, the script should:

Show how to stop the background services
Provide clear next steps for the user

Technical requirements:

The script should work on Ubuntu, Alpine, and other Linux distributions
Keep the script clean and modular (avoid excessive length)
Use functions for all major tasks:
- Install the latest stable release (accepts a URL as a parameter)
- Move and rename binaries (accepts binary name and target path)
- Check system dependencies
- Install system dependencies
- Print the entry point and handle user confirmation

P.S. After successful implementation, we should:

Add a CI workflow to run the script and ensure the installation flow works reliably without issues
Update all documentation to reflect the new installers, so we clearly support both build-from-source and single-install approaches

### Description A script to install all required binaries from release pages and move them to the appropriate path. Think of it like: ```sh curl --proto '=https' --tlsv1.2 -sSf https://forge.ourworld.tf/lhumina_code/hero_compute/scripts/install.sh | sh ``` ### The script should: 1. Install the latest stable version of `hero_proc` from: [https://forge.ourworld.tf/lhumina_code/hero_proc/releases](https://forge.ourworld.tf/lhumina_code/hero_proc/releases) 2. Install the latest stable version of `mycelium` from: [https://github.com/threefoldtech/mycelium/releases](https://github.com/threefoldtech/mycelium/releases) 3. Install the latest stable version of `my_hypervisor` from: [https://forge.ourworld.tf/geomind_code/my_hypervisor/releases](https://forge.ourworld.tf/geomind_code/my_hypervisor/releases) 4. Install the latest stable version of `cloud-hypervisor` from: [https://github.com/cloud-hypervisor/cloud-hypervisor/releases/](https://github.com/cloud-hypervisor/cloud-hypervisor/releases/) 5. Download all required binaries for `hero_compute` from: [https://forge.ourworld.tf/lhumina_code/hero_compute/releases](https://forge.ourworld.tf/lhumina_code/hero_compute/releases) --- ### Post-installation steps: * Make all downloaded files executable * Rename them to match their repository names * Move them to the Hero binary path > Note: > The binaries should be moved to the Hero path (`~/hero/bin`) — not the system path. > No changes should be made to the user's system PATH. --- ### System dependencies: After installing all binaries: * Check for required system dependencies * If any are missing, install them automatically --- ### Service setup: After confirming that all binaries and dependencies are installed: * Start required services (e.g., `hero_proc`, `mycelium`) in the background using the central config peers * Print the next steps for the user, for example: ```sh hero_compute start --mode master ``` --- ### User confirmation: Before starting the installation, the script should: * Clearly print all planned actions * Ask for user confirmation Example: ``` Some system dependencies are missing. You can either allow us to install them, or exit and install them manually. System packages to install: - iproute2 - net-tools Binaries to install: - mycelium - hero_proc - my_hypervisor Services that will run in the background: - mycelium - hero_proc All binaries will be moved to: ~/hero/bin Do you want to continue? (y/n) ``` --- ### Final output: After installation completes, the script should: * Show how to stop the background services * Provide clear next steps for the user --- ### Technical requirements: * The script should work on Ubuntu, Alpine, and other Linux distributions * Keep the script clean and modular (avoid excessive length) * Use functions for all major tasks: * Install the latest stable release (accepts a URL as a parameter) * Move and rename binaries (accepts binary name and target path) * Check system dependencies * Install system dependencies * Print the entry point and handle user confirmation --- **P.S.** After successful implementation, we should: * Add a CI workflow to run the script and ensure the installation flow works reliably without issues * Update all documentation to reflect the new installers, so we clearly support both build-from-source and single-install approaches

mahmoud self-assigned this

2026-04-06 10:24:47 +00:00

mahmoud added this to the ACTIVE project

2026-04-06 10:24:50 +00:00

mahmoud added this to the later milestone

2026-04-06 10:24:52 +00:00

mahmoud commented

2026-04-06 10:29:41 +00:00

Author

Owner

Implementation Spec for Issue #63 — Install Script

Objective

Create a standalone shell install script (scripts/install.sh) that downloads pre-built binaries for the entire Hero Compute stack from their respective release pages, installs them to ~/hero/bin, starts required services (hero_proc, mycelium), and works across Ubuntu, Alpine, and other Linux distributions.

Requirements

Download latest stable binaries from release pages:
- hero_proc (3 binaries) from forge.ourworld.tf/lhumina_code/hero_proc
- mycelium from github.com/threefoldtech/mycelium
- my_hypervisor (2 binaries) from forge.ourworld.tf/geomind_code/my_hypervisor
- cloud-hypervisor from github.com/cloud-hypervisor/cloud-hypervisor
- hero_compute (4 binaries) from forge.ourworld.tf/lhumina_code/hero_compute
Post-install: make all binaries executable, place in ~/hero/bin
Detect and install system dependencies (apt, apk, dnf/yum + fallback)
Start hero_proc_server and mycelium with central config peers
User confirmation before installing (y/n)
Display stop commands and next steps
Cross-distro: Ubuntu, Alpine, RHEL/Fedora
Modular script using functions, matching scripts/configure.sh conventions

Files to Create

File	Description
`scripts/install.sh`	Main install script — standalone, downloads pre-built binaries, installs deps, starts services

Implementation Plan