# 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`](https://git.arka-ai.ru/arka/agent-arka). Сборки и этот установщик публичные, без токена. Версия пакета: **2026.10.7**. ## Установка (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-<версия>-.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.10.7 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 ``` На **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](https://arka-ai.ru) для входа в дашборд - Ключ API для моделей: [arka-ai.ru → API keys](https://arka-ai.ru). Один раз показывается секрет. В `~/.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` с [страницы релиза](https://git.arka-ai.ru/arka/public/releases/tag/agent-arka-v2026.10.7). - Установщик **не подписан**. 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. ## Команды после установки ```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 печатает его один раз. --- # 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`. ```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. On **pc162** (Armbian aarch64, PocketClaw) the same command fetches `linux-aarch64`. On Windows, download `Agent Arka_*_x64-setup.exe` from . 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.7`. 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 (Linux tarballs, Windows NSIS, `SHA256SUMS`):