Files
herolib/lib
despiegk a4472f095e Merge branch 'development' into development_builders
* development:
  minor example fixes
  feat: add comprehensive SSH agent management command
  refactor: Harden and improve SSH agent module
  ...
  feat: add editable ttyd dashboard mode
  feat: add CLI for dashboard management and 4-pane layout
  fix: Fix build
  ...
  refactor: update SSH agent examples and module structure
  feat: add tmux dashboard with ttyd integration
  refactor: Remove is_tmux_server_not_running_error function
  wip: pushing the code to sync in other branch
  refactor: Improve tmux API consistency and formatting

# Conflicts:
#	lib/osal/core/net.v
#	lib/virt/podman/factory.v
2025-08-28 14:26:06 +02:00
..
...
2025-08-15 07:09:40 +02:00
...
2025-05-04 08:19:47 +03:00
...
2025-08-28 13:28:05 +02:00
...
2025-08-25 06:29:42 +02:00
...
2025-07-21 06:18:46 +02:00
...
2025-08-16 10:07:35 +02:00
...
2025-05-04 08:19:47 +03:00
...
2025-08-06 08:50:32 +02:00
2025-08-28 05:39:51 +02:00
...
2025-08-21 12:05:20 +02:00
...
2025-08-15 07:09:40 +02:00
...
2025-08-19 05:51:43 +02:00
...
2025-08-28 09:17:10 +02:00
2024-12-25 21:48:03 +01:00
...
2025-05-04 08:19:47 +03:00
2024-12-25 12:23:15 +01:00

herolib

Is an opinionated library as used by threefold mainly to automate cloud environments, its still very much work in progress and we welcome any contribution.

Please check also our cookbook which might give some ideas how to use it.

Get started with hero

curl -sL https://raw.githubusercontent.com/freeflowuniverse/herolib/development/scripts/install_hero.sh | bash

Get started with herolib

the following script will install vlang and herolib (report bugs please)

curl https://raw.githubusercontent.com/freeflowuniverse/herolib/development/scripts/installer.sh > /tmp/install.sh
bash /tmp/install.sh

optional requirements

  • ssh key loaded for access to github

alternative with manual git checkout & v install

requirements

  • v installed
  • ssh key loaded for access to github
mkdir -p ~/code/github/freeflowuniverse
cd ~/code/github/freeflowuniverse
git clone git@github.com:freeflowuniverse/herolib.git
cd herolib
# checkout a branch with most recent changes
# git checkout development 
bash install.sh

Install Hero

hero is our "hero" tool to execute heroscript, deal with git, ...

hero will be installed in

  • /usr/local/bin for linux
  • ~/hero/bin for osx
curl https://raw.githubusercontent.com/freeflowuniverse/herolib/development/scripts/install_hero.sh > /tmp/hero_install.sh
bash /tmp/hero_install.sh
#to debug
bash -x /tmp/hero_install.sh
#maybe you want to copy to your system bin dir
cp ~/hero/bin/hero /usr/local/bin
#to use hero make sure you restart your shell or you do (if osx)
source ~/.zprofile 
#check how to use, can also do on each of the subcommands
hero -help

requirements

  • ssh key loaded for access to github

generating docs yourself

#cd in this directory
cd ~/code/github/freeflowuniverse/herolib
bash doc.sh

build hero

  • linux as done by github actions, nothing to do
  • osx: ``