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:
ixoblakp committed
1 parent
84dc5874e4
commit
5170fab5e8
4 files changed
+360
No files matched your search
@@ -0,0 +1,110 @@
|
||||
# Agent Arka — дистрибутив с веб-интерфейсом
|
||||
|
||||
Ставит CLI `agent-arka`, поднимает демон и открывает **веб-дашборд** на `http://127.0.0.1:4545`. Это не приложение Tauri (Dock / NSIS); это агент с браузерным UI.
|
||||
|
||||
Исходники приватны: [`arka/agent-arka`](https://git.arka-ai.ru/arka/agent-arka). Сборки и этот установщик публичные, без токена.
|
||||
|
||||
Версия пакета: **2026.9.1**.
|
||||
|
||||
## Установка (Linux / WSL)
|
||||
|
||||
```bash
|
||||
curl -fsSL https://git.arka-ai.ru/arka/public/raw/branch/main/agent-arka/install.sh | bash
|
||||
```
|
||||
|
||||
Скрипт:
|
||||
|
||||
1. Определяет OS/CPU и качает `agent-arka-<версия>-<platform>.tar.gz` из [релизов этого репозитория](https://git.arka-ai.ru/arka/public/releases).
|
||||
2. Проверяет SHA-256.
|
||||
3. Кладёт бинарник в `~/.agent-arka/bin` (если уже есть `~/.librefang` — туда). Совместимое имя `librefang` — симлинк.
|
||||
4. Если нет `config.toml`, запускает `agent-arka init --quick` (Sign in with Arka, случайный пароль оператора печатается один раз).
|
||||
5. Если порт **4545 свободен**, запускает `agent-arka start`.
|
||||
|
||||
Дальше в браузере: [http://127.0.0.1:4545](http://127.0.0.1:4545) → вкладка **Arka AI**.
|
||||
|
||||
Зафиксировать версию:
|
||||
|
||||
```bash
|
||||
curl -fsSL https://git.arka-ai.ru/arka/public/raw/branch/main/agent-arka/install.sh \
|
||||
| AGENT_ARKA_VERSION=2026.9.1 bash
|
||||
```
|
||||
|
||||
Не стартовать демон:
|
||||
|
||||
```bash
|
||||
curl -fsSL https://git.arka-ai.ru/arka/public/raw/branch/main/agent-arka/install.sh \
|
||||
| AGENT_ARKA_AUTO_START=0 bash
|
||||
agent-arka start
|
||||
```
|
||||
|
||||
## Что нужно
|
||||
|
||||
- `curl`, `tar`, `sha256sum` (Linux) или `shasum` (macOS)
|
||||
- glibc: пакет `linux-x86_64` / `linux-aarch64` собран на Ubuntu 22.04 (glibc 2.35) — идёт на Debian/Ubuntu 22.04+
|
||||
- Аккаунт [arka-ai.ru](https://arka-ai.ru) для входа в дашборд
|
||||
- Ключ API для моделей: [arka-ai.ru → API keys](https://arka-ai.ru). Один раз показывается секрет. В `~/.agent-arka/secrets.env` (или `~/.librefang/secrets.env`):
|
||||
|
||||
```
|
||||
ARKA_API_KEY=sk-...
|
||||
```
|
||||
|
||||
После правки `secrets.env` перезапуск: `agent-arka restart`.
|
||||
|
||||
## Платформы
|
||||
|
||||
| Архив | Для кого |
|
||||
|-------|----------|
|
||||
| `agent-arka-*-linux-x86_64.tar.gz` | Linux / WSL, x86_64 (glibc ≥ 2.35) |
|
||||
| `agent-arka-*-linux-aarch64.tar.gz` | Linux aarch64 (Orange Pi, PC162, Ampere; glibc ≥ 2.35) |
|
||||
|
||||
macOS и Windows native в этом релизе **нет** (установщик на Darwin честно завершится с ошибкой скачивания). На Mac — Desktop DMG, когда он опубликован; на Windows — WSL (`wsl --install`) и команда Linux выше.
|
||||
|
||||
## Команды после установки
|
||||
|
||||
```bash
|
||||
agent-arka --version
|
||||
agent-arka start # демон, веб на :4545
|
||||
agent-arka stop
|
||||
agent-arka restart
|
||||
agent-arka doctor
|
||||
```
|
||||
|
||||
Логи: `$HOME/.agent-arka/logs/` (или `.librefang`).
|
||||
|
||||
Порт занят — не убивайте чужой процесс. Либо остановите свой старый демон (`agent-arka stop`), либо задайте другой listen в `config.toml` (`api_listen`).
|
||||
|
||||
## Вход
|
||||
|
||||
На свежей установке в `config.toml` уже включён официальный OIDC-клиент `agent-arka` (PKCE, без секрета). Кнопка **Arka AI** должна быть на экране логина.
|
||||
|
||||
Колбэк по умолчанию: `http://127.0.0.1:4545/api/auth/callback` и `http://localhost:4545/api/auth/callback`. Если открываете дашборд по другому hostname, этот origin должен быть зарегистрирован на IdP — иначе будет «Redirect URI not registered». Для одного пользователя на своей машине открывайте именно `http://127.0.0.1:4545`.
|
||||
|
||||
Пароль вкладки Password — аварийный (`dashboard_user = operator`). Init печатает его один раз.
|
||||
|
||||
## Сборка из исходников (если нет пакета под вашу OS)
|
||||
|
||||
Репозиторий приватный. У кого есть доступ:
|
||||
|
||||
```bash
|
||||
cargo install --git ssh://git@git.arka-ai.ru:4001/arka/agent-arka.git librefang-cli --bin agent-arka
|
||||
agent-arka init --quick
|
||||
agent-arka start
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
# Agent Arka — web UI distribution
|
||||
|
||||
Installs the `agent-arka` CLI, starts the daemon, and serves the **browser dashboard** at `http://127.0.0.1:4545`. This is not the Tauri desktop app.
|
||||
|
||||
```bash
|
||||
curl -fsSL https://git.arka-ai.ru/arka/public/raw/branch/main/agent-arka/install.sh | bash
|
||||
```
|
||||
|
||||
Then open [http://127.0.0.1:4545](http://127.0.0.1:4545) and use **Arka AI** to sign in.
|
||||
|
||||
Pin a version with `AGENT_ARKA_VERSION=2026.9.1`. Skip autostart with `AGENT_ARKA_AUTO_START=0`.
|
||||
|
||||
Put `ARKA_API_KEY` in `~/.agent-arka/secrets.env` (or `~/.librefang/secrets.env` if that home already exists). Create a key at [arka-ai.ru](https://arka-ai.ru).
|
||||
|
||||
Releases (tarballs + `SHA256SUMS`): <https://git.arka-ai.ru/arka/public/releases>
|
||||
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