ixoblakp
5170fab5e8
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).
111 lines
5.3 KiB
Markdown
111 lines
5.3 KiB
Markdown
# 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>
|