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>
|
||||
Reference in new issue
Block a user