124 lines
6.5 KiB
Markdown
124 lines
6.5 KiB
Markdown
# 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-<версия>-<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.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 <https://git.arka-ai.ru/arka/public/releases/tag/agent-arka-v2026.10.7>.
|
||
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`): <https://git.arka-ai.ru/arka/public/releases>
|