Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates. Includes Local workflows for coding assistants.
JavaScript agent-orchestrationagentic-workflowai-agentsai-codingclaude-codecode-reviewcodebuddycodexcoding-agentscursordeveloper-toolshuman-on-the-loopllmmcpmulti-agentsdlcself-hostedsopworkflow-automationworkflow-engine
#!/usr/bin/env bash
# One-command container installation from the published GHCR image pinned in
# compose.yaml (LOOPFORGE_BUILD_FROM_SOURCE=1 builds this checkout instead).
# Installs Docker when it is missing (Linux, or macOS with Homebrew) and needs
# Python 3 and curl (apt/dnf/yum, or Homebrew). Re-running is safe: secrets,
# data and catalog edits are kept.
set -euo pipefail
cd "$(dirname "$0")/.."
fail() { printf '\n✗ %s\n' "$1" >&2; exit 1; }
step() { printf '\n▸ %s\n' "$1"; }
source scripts/docker-access.sh
source scripts/ghcr-mirror.sh
confirm() {
[[ "${LOOPFORGE_YES:-}" == 1 ]] && return 0
[[ -t 0 ]] || return 1
read -r -p "$1 [Y/n] " answer
[[ -z "$answer" || "$answer" =~ ^[Yy] ]]
}
usable_python() {
command -v python3 >/dev/null && python3 -c 'import sys; sys.exit(sys.version_info < (3, 6))' >/dev/null 2>&1
}
install_prerequisites() {
local missing=()
usable_python || missing+=(python3)
command -v curl >/dev/null || missing+=(curl ca-certificates)
[[ ${#missing[@]} -gt 0 ]] || return 0
confirm "Required packages are missing: ${missing[*]}. Install them now?" \
|| fail 'Install Python 3 and curl, then rerun this script; or rerun with LOOPFORGE_YES=1 to accept installation.'
if command -v apt-get >/dev/null; then
as_root apt-get update
if [[ ${LOOPFORGE_YES:-0} == 1 ]]; then
as_root env DEBIAN_FRONTEND=noninteractive NEEDRESTART_MODE=a \
apt-get -o Dpkg::Options::=--force-confdef -o Dpkg::Options::=--force-confold install -y "${missing[@]}"
else
as_root apt-get install -y "${missing[@]}"
fi
elif command -v dnf >/dev/null; then
as_root dnf install -y "${missing[@]}"
elif command -v yum >/dev/null; then
as_root yum install -y "${missing[@]}"
elif [[ $(uname -s) == Darwin ]] && command -v brew >/dev/null; then
brew install "${missing[@]}"
else
fail 'Automatic prerequisite installation requires apt, dnf, yum or Homebrew. Install Python 3 and curl, then rerun this script.'
fi
usable_python && command -v curl >/dev/null \
|| fail 'A working Python 3 or curl is still unavailable after package installation. Check the package manager output and rerun.'
}
install_compose() (
[[ $(uname -s) == Linux ]] \
|| fail 'Docker Compose is unavailable. Install or update Docker Desktop, then rerun this script.'
confirm 'Docker Compose is missing. Install the official checksum-verified plugin now?' \
|| fail 'Docker Compose is required. Install the plugin or rerun with LOOPFORGE_YES=1.'
local temporary plugin_dir
temporary=$(mktemp -d)
trap 'rm -rf "$temporary"' EXIT
if ! python3 scripts/install-compose.py "$temporary/docker-compose" "$(uname -m)"; then
fail 'Docker Compose download failed. Check access to GitHub, or install the Compose plugin manually and rerun.'
fi
if [[ ${LOOPFORGE_DOCKER_USE_SUDO:-0} == 1 || $(id -u) -eq 0 ]]; then
plugin_dir=/usr/local/lib/docker/cli-plugins
if ! { as_root install -d "$plugin_dir" && as_root install -m 0755 "$temporary/docker-compose" "$plugin_dir/docker-compose"; }; then
fail "Could not install Docker Compose in $plugin_dir. Check directory permissions and rerun."
fi
else
plugin_dir="${DOCKER_CONFIG:-$HOME/.docker}/cli-plugins"
if ! { install -d "$plugin_dir" && install -m 0755 "$temporary/docker-compose" "$plugin_dir/docker-compose"; }; then
fail "Could not install Docker Compose in $plugin_dir. Check directory permissions and rerun."
fi
fi
)
install_docker() {
case "$(uname -s)" in
Linux)
confirm 'Docker is not installed. Install it now with the official script (get.docker.com)?' \
|| fail 'Docker is required. Install it from https://docs.docker.com/engine/install/ or rerun with LOOPFORGE_YES=1.'
command -v curl >/dev/null || fail 'curl is required to install Docker.'
installer=$(mktemp)
curl --connect-timeout 10 --max-time 120 -fsSL https://get.docker.com -o "$installer" || { rm -f "$installer"; fail 'Could not download the Docker installer.'; }
as_root sh "$installer"
rm -f "$installer"
as_root systemctl enable --now docker 2>/dev/null || as_root service docker start
;;
Darwin)
command -v brew >/dev/null && confirm 'Docker is not installed. Install Docker Desktop with Homebrew?' \
|| fail 'Install Docker Desktop from https://docs.docker.com/desktop/setup/install/mac-install/ and run this script again.'
brew install --cask docker
open -a Docker
;;
*) fail 'Install Docker from https://docs.docker.com/get-docker/ and run this script again.' ;;
esac
}
wait_for_docker() {
for _ in $(seq 1 30); do select_docker_access && return 0; sleep 2; done
return 1
}
step 'Checking prerequisites'
install_prerequisites
command -v docker >/dev/null || install_docker
if ! select_docker_access; then
case "$(uname -s)" in
Linux) as_root systemctl start docker 2>/dev/null || as_root service docker start 2>/dev/null || true ;;
Darwin) open -a Docker 2>/dev/null || true ;;
esac
wait_for_docker || fail 'Docker is installed but not running, or this user cannot access it (try: sudo usermod -aG docker "$USER", then log in again).'
fi
docker_access compose version >/dev/null 2>&1 || install_compose
docker_access compose version >/dev/null 2>&1 || fail 'Docker Compose is still unavailable. Check the Docker CLI plugin configuration and rerun.'
requested_public_url="${LOOPFORGE_PUBLIC_URL:-}"
[[ ! -e .env || -r .env ]] || fail 'The existing .env is not readable by this user. Use the installation owner or ask an administrator to correct its ownership.'
bash scripts/configure.sh
[[ -r .env ]] || fail 'The existing .env is not readable by this user. Use the installation owner or ask an administrator to correct its ownership.'
set -a; source .env; set +a
export LOOPFORGE_BIND="${LOOPFORGE_BIND:-0.0.0.0}"
if [[ -n "$requested_public_url" ]]; then export LOOPFORGE_PUBLIC_URL="$requested_public_url"; fi
python3 scripts/install-address.py --prepare "${AGENTFLOW_HTTP_PORT:-8090}"
set -a; source .env; set +a
if [[ -z "${LOOPFORGE_DOCKER_SOCKET:-}" ]]; then
docker_host="${DOCKER_HOST:-$(docker_access context inspect --format '{{(index .Endpoints "docker").Host}}' 2>/dev/null || true)}"
case "$docker_host" in
unix://*) export LOOPFORGE_DOCKER_SOCKET="${docker_host#unix://}" ;;
'') export LOOPFORGE_DOCKER_SOCKET=/var/run/docker.sock ;;
*) fail 'This installer requires a local Docker socket for sandbox bind mounts. Select a local/rootless Docker context or configure remote workers manually.' ;;
esac
python3 - <<'PY'
import os,pathlib,shlex
with pathlib.Path('.env').open('a') as config:
config.write('\nLOOPFORGE_DOCKER_SOCKET='+shlex.quote(os.environ['LOOPFORGE_DOCKER_SOCKET'])+'\n')
PY
fi
python3 - <<'PY'
import runpy
runpy.run_path('scripts/install-address.py')['access_addresses']('8090')
PY
mkdir -p "$LOOPFORGE_DATA_DIR/home" "$LOOPFORGE_DATA_DIR/workspaces" || fail 'The data directory is not writable. Set LOOPFORGE_DATA_DIR in .env to a directory owned by this user.'
port="${AGENTFLOW_HTTP_PORT:-8090}"
if ! docker_access compose ps --status running --services 2>/dev/null | grep -qx platform; then
if (exec 3<>"/dev/tcp/127.0.0.1/$port") 2>/dev/null; then
fail "Port $port is already in use. Set AGENTFLOW_HTTP_PORT in .env to a free port and run again."
fi
fi
dev_compose=compose.yaml:compose.dev.yaml
if [[ "${LOOPFORGE_BUILD_FROM_SOURCE:-0}" == 1 && "${COMPOSE_FILE:-}" != "$dev_compose" ]]; then
# Persisted because sudo-run Compose only reads .env; later plain compose commands keep the source stack.
python3 - "$dev_compose" <<'PY'
import pathlib,re,sys
p=pathlib.Path('.env')
text=re.sub(r'(?m)^COMPOSE_FILE=.*\n?','',p.read_text())
p.write_text(text.rstrip('\n')+'\nCOMPOSE_FILE='+sys.argv[1]+'\n')
PY
export COMPOSE_FILE="$dev_compose"
fi
if [[ "${COMPOSE_FILE:-}" != "$dev_compose" ]]; then
pull_policy="${LOOPFORGE_PULL_POLICY:-missing}"
if mirror_published_ghcr "$pull_policy"; then
# The platform name is already local. Pull it with missing so Compose does
# not contact ghcr.io; MySQL keeps the requested policy.
if [[ "$pull_policy" == always ]]; then
docker_access compose --profile platform pull --policy missing platform
docker_access compose --profile platform pull --policy always mysql
else
docker_access compose --profile platform pull --policy "$pull_policy" platform mysql
fi
else
step "Pulling the published LoopForge image ${LOOPFORGE_IMAGE:-pinned in compose.yaml}"
docker_access compose --profile platform pull --policy "$pull_policy" platform mysql
fi
docker_access compose --profile platform up -d --no-build --wait --wait-timeout 180
else
step 'Building LoopForge from source (first install takes several minutes; frontend, Go and runtime stages build in parallel)'
if [[ -z "${LOOPFORGE_COMMIT:-}" ]]; then
LOOPFORGE_COMMIT="$(git rev-parse HEAD 2>/dev/null || true)"
export LOOPFORGE_COMMIT
fi
# Download MySQL while the platform image builds instead of afterwards.
docker_access compose pull --quiet --policy missing mysql >/dev/null 2>&1 &
mysql_pull=$!
docker_access compose --profile platform build platform
wait "$mysql_pull" || true
step 'Starting LoopForge'
docker_access compose --profile platform up -d --no-build --wait --wait-timeout 180
fi
step 'Installing the schema extensions and the starter catalog'
bash scripts/install-schema-extensions.sh
python3 scripts/install-address.py "$port"
users=$(docker_access compose exec -T mysql sh -c 'MYSQL_PWD="$MYSQL_PASSWORD" mysql -N -u loopforge loopforge -e "select count(*) from users"' 2>/dev/null || echo 0)
if [[ "${users//[^0-9]/}" == 0 ]]; then
printf ' Open it in your browser and create the administrator account.\n'
else
printf ' Open it in your browser and sign in.\n'
fi
printf ' Default sandboxes reuse the installed runtime image; no second CLI image build is needed.\n'
printf ' Stop: ./start.sh stop · Logs: ./start.sh logs · Update images: ./start.sh pull\n'