public/agent-arka/README.md

Agent Arka — дистрибутив с веб-интерфейсом и Windows desktop

На Linux / WSL ставит CLI agent-arka, поднимает демон и открывает веб-дашборд на http://127.0.0.1:4545. На Windows — отдельный установщик NSIS (Agent Arka_*_x64-setup.exe): то же ядро и дашборд внутри окна Tauri.

Исходники приватны: arka/agent-arka. Сборки и этот установщик публичные, без токена.

Версия пакета: 2026.10.4.

Установка (Linux / WSL)

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 из релизов этого репозитория.
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 → вкладка Arka AI.

Зафиксировать версию:

curl -fsSL https://git.arka-ai.ru/arka/public/raw/branch/main/agent-arka/install.sh \
  | AGENT_ARKA_VERSION=2026.10.4 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

На pc162 (Armbian aarch64, PocketClaw) та же команда: установщик сам берёт linux-aarch64.

Что нужно

• 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 для входа в дашборд
• Ключ API для моделей: arka-ai.ru → API keys. Один раз показывается секрет. В ~/.agent-arka/secrets.env (или ~/.librefang/secrets.env):

ARKA_API_KEY=ABCDEFGHIJKLMNOPQRSTUVWXYZ234567ABCDEFGHIJKL

Ключ — голый токен: заглавные A–Z и 0–9, ~40 символов, без префикса sk-.

После правки secrets.env перезапуск: agent-arka restart.

Windows (desktop)

Скачайте Agent Arka_*_x64-setup.exe с страницы релиза.

• Установщик не подписан. SmartScreen: «Подробнее» → «Выполнить в любом случае».
• При первой установке нужен интернет: подтягивается WebView2 Evergreen, если его ещё нет.
• Демон слушает http://127.0.0.1:4545 внутри приложения.

Альтернатива на Windows — WSL (wsl --install) и команда Linux выше.

Платформы

Архив	Для кого
agent-arka-*-linux-x86_64.tar.gz	Linux / WSL, x86_64 (glibc ≥ 2.35)
agent-arka-*-linux-aarch64.tar.gz	Linux aarch64 — Armbian / pc162 (PocketClaw, sunxi64), Orange Pi, Ampere (glibc ≥ 2.35)
Agent Arka_*_x64-setup.exe	Windows 10/11 x64, desktop (NSIS)
Agent Arka_*_aarch64.dmg	macOS Apple Silicon (arm64), desktop

macOS — только Apple Silicon (arm64), в виде Agent Arka_*_aarch64.dmg. Интел (x86_64) версии нет. Установщик на Darwin из tarball завершится ошибкой скачивания — используйте DMG.

Команды после установки

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 печатает его один раз.

---

Agent Arka — web UI and Windows desktop

On Linux / WSL this installs the agent-arka CLI, starts the daemon, and serves the browser dashboard at http://127.0.0.1:4545.

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 and use Arka AI to sign in.

On pc162 (Armbian aarch64, PocketClaw) the same command fetches linux-aarch64.

On Windows, download Agent Arka_*_x64-setup.exe from https://git.arka-ai.ru/arka/public/releases/tag/agent-arka-v2026.10.4. The installer is unsigned: SmartScreen → More info → Run anyway. First install needs network for the WebView2 Evergreen bootstrapper.

Pin a version with AGENT_ARKA_VERSION=2026.10.4. 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.

Releases (Linux tarballs, Windows NSIS, SHA256SUMS): https://git.arka-ai.ru/arka/public/releases