feat(agent-arka): add web-dashboard installer and instructions
Public curl|bash path for the daemon + browser UI at :4545. Binaries ship as release assets on this repo (private agent-arka source stays private).
This commit is contained in:
1 parent
84dc5874e4
commit
5170fab5e8
4 files changed
+360
No files matched your search
Executable
+233
@@ -0,0 +1,233 @@
|
||||
#!/usr/bin/env bash
|
||||
# Agent Arka — daemon + web dashboard installer (Linux / macOS / WSL).
|
||||
#
|
||||
# curl -fsSL https://git.arka-ai.ru/arka/public/raw/branch/main/agent-arka/install.sh | bash
|
||||
#
|
||||
# Environment:
|
||||
# AGENT_ARKA_VERSION pin a release (e.g. 2026.9.1). Default: newest agent-arka-v* on git.arka-ai.ru/arka/public
|
||||
# AGENT_ARKA_HOME data dir. Existing ~/.librefang is reused; else ~/.agent-arka
|
||||
# AGENT_ARKA_INSTALL_DIR binary dir (default: $AGENT_ARKA_HOME/bin)
|
||||
# AGENT_ARKA_AUTO_START 1/true/yes to run `agent-arka start` when :4545 is free (default: 1)
|
||||
# AGENT_ARKA_INIT 1 to run `agent-arka init --quick` when no config.toml exists (default: 1)
|
||||
# LIBREFANG_* names for the same keys still work.
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
PUBLIC_API="${AGENT_ARKA_PUBLIC_API:-https://git.arka-ai.ru/api/v1}"
|
||||
PUBLIC_DL="${AGENT_ARKA_PUBLIC_DL:-https://git.arka-ai.ru/arka/public/releases/download}"
|
||||
REPO="arka/public"
|
||||
TAG_PREFIX="agent-arka-v"
|
||||
|
||||
if [[ -t 1 && -z "${NO_COLOR:-}" ]]; then
|
||||
C_GREEN=$'\033[32m'
|
||||
C_YELLOW=$'\033[33m'
|
||||
C_RED=$'\033[31m'
|
||||
C_BOLD=$'\033[1m'
|
||||
C_RESET=$'\033[0m'
|
||||
else
|
||||
C_GREEN='' C_YELLOW='' C_RED='' C_BOLD='' C_RESET=''
|
||||
fi
|
||||
|
||||
info() { printf '%s\n' "$*"; }
|
||||
ok() { printf '%s✓%s %s\n' "$C_GREEN" "$C_RESET" "$*"; }
|
||||
warn() { printf '%s⚠%s %s\n' "$C_YELLOW" "$C_RESET" "$*"; }
|
||||
die() { printf '%s✗%s %s\n' "$C_RED" "$C_RESET" "$*" >&2; exit 1; }
|
||||
|
||||
brand_env() {
|
||||
local suffix="$1"
|
||||
local new_name="AGENT_ARKA_${suffix}"
|
||||
local old_name="LIBREFANG_${suffix}"
|
||||
local value="${!new_name:-}"
|
||||
if [[ -n "${value// }" ]]; then
|
||||
printf '%s\n' "$value"
|
||||
return 0
|
||||
fi
|
||||
value="${!old_name:-}"
|
||||
if [[ -n "${value// }" ]]; then
|
||||
printf '%s\n' "$value"
|
||||
return 0
|
||||
fi
|
||||
return 1
|
||||
}
|
||||
|
||||
is_on() {
|
||||
case "${1:-}" in
|
||||
1|true|TRUE|yes|YES|on|ON) return 0 ;;
|
||||
*) return 1 ;;
|
||||
esac
|
||||
}
|
||||
|
||||
detect_platform() {
|
||||
local os arch
|
||||
os=$(uname -s | tr '[:upper:]' '[:lower:]')
|
||||
arch=$(uname -m)
|
||||
case "$arch" in
|
||||
x86_64|amd64) arch="x86_64" ;;
|
||||
aarch64|arm64) arch="aarch64" ;;
|
||||
*) die "Unsupported architecture: $arch" ;;
|
||||
esac
|
||||
case "$os" in
|
||||
linux) PLATFORM="linux-${arch}" ;;
|
||||
darwin) PLATFORM="darwin-${arch}" ;;
|
||||
mingw*|msys*|cygwin*)
|
||||
die "On Windows use WSL, then this installer, or wait for the Desktop NSIS build. PowerShell: wsl --install"
|
||||
;;
|
||||
*) die "Unsupported OS: $os" ;;
|
||||
esac
|
||||
}
|
||||
|
||||
resolve_home() {
|
||||
local override
|
||||
if override=$(brand_env HOME 2>/dev/null); then
|
||||
HOME_DIR="$override"
|
||||
return
|
||||
fi
|
||||
if [[ -d "${HOME}/.librefang" ]]; then
|
||||
HOME_DIR="${HOME}/.librefang"
|
||||
return
|
||||
fi
|
||||
HOME_DIR="${HOME}/.agent-arka"
|
||||
}
|
||||
|
||||
port_in_use() {
|
||||
local port="$1"
|
||||
if command -v ss >/dev/null 2>&1; then
|
||||
ss -ltn 2>/dev/null | grep -qE ":${port}([[:space:]]|$)"
|
||||
return $?
|
||||
fi
|
||||
if command -v lsof >/dev/null 2>&1; then
|
||||
lsof -iTCP:"$port" -sTCP:LISTEN >/dev/null 2>&1
|
||||
return $?
|
||||
fi
|
||||
(echo >/dev/tcp/127.0.0.1/"$port") >/dev/null 2>&1
|
||||
}
|
||||
|
||||
fetch_latest_version() {
|
||||
local json tags
|
||||
json=$(curl -fsSL "${PUBLIC_API}/repos/${REPO}/releases?limit=50") || die "Cannot list releases at ${PUBLIC_API}/repos/${REPO}/releases"
|
||||
tags=$(printf '%s' "$json" | grep -oE '"tag_name":[[:space:]]*"'"${TAG_PREFIX}"'[^"]+"' | sed 's/.*"'"${TAG_PREFIX}"'//;s/"$//' || true)
|
||||
if [[ -z "$tags" ]]; then
|
||||
die "No ${TAG_PREFIX}* releases on ${REPO} yet"
|
||||
fi
|
||||
printf '%s\n' "$tags" | head -n 1
|
||||
}
|
||||
|
||||
sha256_file() {
|
||||
if command -v sha256sum >/dev/null 2>&1; then
|
||||
sha256sum "$1" | awk '{print $1}'
|
||||
elif command -v shasum >/dev/null 2>&1; then
|
||||
shasum -a 256 "$1" | awk '{print $1}'
|
||||
else
|
||||
die "Need sha256sum or shasum"
|
||||
fi
|
||||
}
|
||||
|
||||
ensure_path() {
|
||||
local bindir="$1"
|
||||
case ":$PATH:" in
|
||||
*":${bindir}:"*) return 0 ;;
|
||||
esac
|
||||
local line="export PATH=\"${bindir}:\$PATH\""
|
||||
local rc
|
||||
for rc in "${HOME}/.zprofile" "${HOME}/.zshrc" "${HOME}/.bash_profile" "${HOME}/.bashrc" "${HOME}/.profile"; do
|
||||
[[ -f "$rc" ]] || continue
|
||||
if grep -Fqs "$bindir" "$rc"; then
|
||||
return 0
|
||||
fi
|
||||
done
|
||||
if [[ -n "${SHELL:-}" && "${SHELL}" == *zsh* ]]; then
|
||||
rc="${HOME}/.zshrc"
|
||||
else
|
||||
rc="${HOME}/.bashrc"
|
||||
[[ -f "$rc" ]] || rc="${HOME}/.profile"
|
||||
fi
|
||||
printf '\n# Agent Arka\n%s\n' "$line" >>"$rc"
|
||||
warn "Added ${bindir} to PATH in ${rc} (open a new shell, or: source ${rc})"
|
||||
}
|
||||
|
||||
main() {
|
||||
printf '%s\n' "${C_BOLD}Agent Arka${C_RESET} — web dashboard installer"
|
||||
command -v curl >/dev/null 2>&1 || die "curl is required"
|
||||
command -v tar >/dev/null 2>&1 || die "tar is required"
|
||||
|
||||
detect_platform
|
||||
resolve_home
|
||||
local bindir
|
||||
if bindir=$(brand_env INSTALL_DIR 2>/dev/null); then
|
||||
:
|
||||
else
|
||||
bindir="${HOME_DIR}/bin"
|
||||
fi
|
||||
mkdir -p "$bindir" "$HOME_DIR"
|
||||
|
||||
local version
|
||||
if version=$(brand_env VERSION 2>/dev/null); then
|
||||
version="${version#v}"
|
||||
version="${version#agent-arka-v}"
|
||||
info "Using pinned version ${version}"
|
||||
else
|
||||
info "Resolving latest Agent Arka release…"
|
||||
version=$(fetch_latest_version)
|
||||
info "Latest: ${version}"
|
||||
fi
|
||||
|
||||
local tag="${TAG_PREFIX}${version}"
|
||||
local asset="agent-arka-${version}-${PLATFORM}.tar.gz"
|
||||
local url="${PUBLIC_DL}/${tag}/${asset}"
|
||||
local sums_url="${PUBLIC_DL}/${tag}/SHA256SUMS"
|
||||
local tmp
|
||||
tmp=$(mktemp -d)
|
||||
trap 'rm -rf "$tmp"' EXIT
|
||||
|
||||
info "Downloading ${asset}"
|
||||
if ! curl -fL --retry 3 -o "${tmp}/${asset}" "$url"; then
|
||||
die "No package for ${PLATFORM} in ${tag}. See https://git.arka-ai.ru/arka/public/releases"
|
||||
fi
|
||||
curl -fsSL -o "${tmp}/SHA256SUMS" "$sums_url" || die "Missing SHA256SUMS for ${tag}"
|
||||
local expected actual
|
||||
expected=$(grep -E "[[:space:]]${asset}\$" "${tmp}/SHA256SUMS" | awk '{print $1}' | head -n 1)
|
||||
[[ -n "$expected" ]] || die "SHA256SUMS has no entry for ${asset}"
|
||||
actual=$(sha256_file "${tmp}/${asset}")
|
||||
[[ "$expected" == "$actual" ]] || die "SHA256 mismatch for ${asset} (got ${actual}, want ${expected})"
|
||||
ok "Checksum ok"
|
||||
|
||||
tar -xzf "${tmp}/${asset}" -C "$tmp"
|
||||
[[ -f "${tmp}/agent-arka" ]] || die "Archive did not contain agent-arka"
|
||||
chmod 755 "${tmp}/agent-arka"
|
||||
"${tmp}/agent-arka" --version >/dev/null || die "Downloaded binary failed to run on this host"
|
||||
cp -f "${tmp}/agent-arka" "${bindir}/agent-arka"
|
||||
ln -sfn agent-arka "${bindir}/librefang"
|
||||
ok "Installed ${bindir}/agent-arka ($("${bindir}/agent-arka" --version 2>/dev/null | head -n 1))"
|
||||
|
||||
ensure_path "$bindir"
|
||||
export PATH="${bindir}:$PATH"
|
||||
|
||||
local do_init do_start
|
||||
do_init=$(brand_env INIT 2>/dev/null || echo 1)
|
||||
do_start=$(brand_env AUTO_START 2>/dev/null || echo 1)
|
||||
|
||||
if is_on "$do_init" && [[ ! -f "${HOME_DIR}/config.toml" ]]; then
|
||||
info "First run: agent-arka init --quick"
|
||||
AGENT_ARKA_HOME="${HOME_DIR}" LIBREFANG_HOME="${HOME_DIR}" "${bindir}/agent-arka" init --quick || warn "init --quick failed; run: agent-arka init"
|
||||
fi
|
||||
|
||||
if is_on "$do_start"; then
|
||||
if port_in_use 4545; then
|
||||
warn "Port 4545 is already in use — not starting a second daemon"
|
||||
else
|
||||
info "Starting daemon"
|
||||
AGENT_ARKA_HOME="${HOME_DIR}" LIBREFANG_HOME="${HOME_DIR}" "${bindir}/agent-arka" start || warn "agent-arka start failed"
|
||||
fi
|
||||
fi
|
||||
|
||||
printf '\n'
|
||||
ok "Open the web UI: ${C_BOLD}http://127.0.0.1:4545${C_RESET}"
|
||||
info "Sign in with Arka AI (account at https://arka-ai.ru)."
|
||||
info "For models, put ARKA_API_KEY in ${HOME_DIR}/secrets.env (create a key at https://arka-ai.ru)."
|
||||
info "Docs: https://git.arka-ai.ru/arka/public/src/branch/main/agent-arka"
|
||||
}
|
||||
|
||||
if [[ "${AGENT_ARKA_INSTALLER_SOURCE_ONLY:-}" == 1 ]]; then
|
||||
return 0 2>/dev/null || true
|
||||
fi
|
||||
main "$@"
|
||||
Reference in new issue
Block a user