# Как установить Aether на Android: локальный ИИ-агент с bash и офлайн-моделью

> AI Release · @ai_release1 · https://ai-release.org/guides/kak-ustanovit-aether-na-android-lokalnyy-ii-agent-s-bas.html

## TL;DR
- Время выполнения: 30–45 минут (без учёта скачивания файла модели — он может весить несколько гигабайт).
- Уровень сложности: Intermediate (нужны базовые навыки работы с терминалом и USB-отладкой).
- Понадобится: смартфон Android, ПК с Windows/macOS/Linux, USB-кабель с передачей данных, platform-tools (ADB), APK-файл Aether, файл офлайн-модели в поддерживаемом формате, свободное место на телефоне «размер модели + запас на распаковку».

## Требования и подготовка
![Иллюстрация к разделу «Требования и подготовка»](https://ai-release.org/guides/img/kak-ustanovit-aether-na-android-lokalnyy-ii-agent-s-bas-ru-1.jpg?v=1795272118)

- **Android-смартфон.** Минимальную версию ОС и список поддерживаемых архитектур (arm64 и т. п.) сверьте с документацией Aether — в исходных материалах этих цифр нет.
- **ПК и кабель.** Кабель должен передавать данные, а не только ток: на «зарядных» кабелях `adb devices` не увидит устройство.
- **platform-tools (ADB).** ADB — это отладочный мост: утилита на ПК, которая ставит APK и читает логи телефона. Скачайте официальный архив platform-tools для своей ОС и распакуйте, например, в `C:\platform-tools` или `~/platform-tools`.
- **APK-файл Aether.** Берите сборку только из официального источника проекта; конкретный URL сверьте с документацией. Как проверить скачанный APK перед установкой, разобрано в гайде [WordCraft APK для Android: где скачать, как проверить файл и установить](https://ai-release.org/guides/wordcraft-apk-android-skachat.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).
- **Файл офлайн-модели.** Формат (расширение файла) и способ получения сверьте с документацией Aether — не подставляйте произвольный файл, приложение его не загрузит.
- **Свободное место.** Ориентир: размер файла модели плюс 2 ГБ запаса на кэш и распаковку. Точные требования — в документации.
- **Права.** Root не нужен: установка через ADB и работа с файлами в общей памяти выполняются от обычного пользователя.

Проверка готовности — три пункта, которые должны быть истинны до старта:

- [ ] На телефоне включена «Отладка по USB» (Настройки → О системе → 7 раз тапнуть по «Номер сборки» → Настройки → Система → Для разработчиков → Отладка по USB).
- [ ] На ПК в терминале команда `adb` не выдаёт «command not found» / «не является внутренней или внешней командой».
- [ ] На телефоне есть свободное место больше размера файла модели.

**Пример:** если файл модели занимает 4 ГБ, а в «Настройки → Память» свободно 3,2 ГБ, установка пройдёт, а загрузка модели упадёт — освободите место заранее.

## Шаг 1. Подключение телефона и проверка ADB
**Что сделать:** подключите телефон кабелем к ПК, в уведомлении на телефоне выберите режим «Передача файлов» (MTP), затем выполните в терминале ПК:

```bash
adb version
adb devices
```

**Зачем:** `adb version` подтверждает, что platform-tools распакованы и путь к ним доступен, а `adb devices` — что ПК видит конкретное устройство и ему разрешён доступ.

**Как проверить:** первая команда печатает строку вида `Android Debug Bridge version 1.0.xx`. Вторая — список устройств:

```
List of devices attached
R58M12ABCDE	device
```

Слово `device` в конце строки означает «готов к работе». Если там `unauthorized` — разблокируйте телефон и нажмите «Разрешить» в окне «Разрешить отладку по USB?» (поставьте галочку «Всегда разрешать с этого компьютера»). Если список пуст — смените кабель или порт USB.

**Пример:** строка `R58M12ABCDE	unauthorized` → подтвердили окно на экране → повторный `adb devices` даёт `R58M12ABCDE	device`.

Почему это работает: ADB-сервер на ПК обменивается с демоном `adbd` на телефоне по USB, а ключ сопряжения хранится в `~/.android/adbkey` — поэтому окно подтверждения появляется один раз на компьютер.

## Шаг 2. Установка Aether и загрузка офлайн-модели
![Иллюстрация к разделу «Шаг 2. Установка Aether и загрузка офлайн-модели»](https://ai-release.org/guides/img/kak-ustanovit-aether-na-android-lokalnyy-ii-agent-s-bas-ru-2.jpg?v=1795272124)

**Что сделать:** установите APK и положите файл модели в память телефона.

```bash
adb install -r "/путь/к/Aether.apk"
```

Флаг `-r` переустанавливает приложение с сохранением данных. Ожидаемый вывод:

```
Performing Streamed Install
Success
```

Затем скопируйте модель в общую память устройства (папку создаём заранее, чтобы не ловить ошибку «No such file or directory»):

```bash
adb shell mkdir -p /sdcard/Download/models
adb push "/путь/к/model.gguf" /sdcard/Download/models/
```

`/sdcard/Download/models/` — пример пути; замените `model.gguf` на реальное имя вашего файла. Ожидаемый вывод `adb push` — строка прогресса вида `1 file pushed, 0 skipped` и скорость в MB/s.

**Зачем:** приложение не скачивает модель из сети (это и есть офлайн-режим), поэтому файл нужно положить на устройство вручную — по кабелю это быстрее и надёжнее, чем через браузер.

**Как проверить:** откройте Aether, найдите раздел настроек модели и укажите папку/файл. Точные названия пунктов меню и поддерживаемый формат сверьте с документацией проекта — в исходных материалах их нет. Успех выглядит так: приложение показывает имя файла и статус вида «загружено / ready», а поле ввода чата становится активным.

**Пример:** вы скопировали `qwen-model.gguf` в `/sdcard/Download/models/`; в приложении выбираете эту папку, видите имя файла и статус загрузки — после него можно отправлять запрос.

Отдельно проверьте bash-часть: Aether даёт локальный терминал с bash (оболочка командной строки). Откройте его и выполните:

```bash
pwd
echo "bash ok"
```

Ожидаемый вывод — путь (например, `/data/user/0/<package.name>/files`) и строка `bash ok`. Если команды выполняются, значит оболочка запущена и это не веб-обёртка.

Почему это работает: модель лежит файлом в памяти телефона, а инференс (вычисление ответа) идёт на процессоре/ускорителе устройства — сеть в этой цепочке не участвует.

## Шаг 3. Проверка офлайн-работы и финальный результат
![Иллюстрация к разделу «Шаг 3. Проверка офлайн-работы и финальный результат»](https://ai-release.org/guides/img/kak-ustanovit-aether-na-android-lokalnyy-ii-agent-s-bas-ru-3.jpg?v=1795272130)

**Что сделать:** включите авиарежим и повторите тот же запрос, что делали до этого.

```bash
adb shell settings put global airplane_mode_on 1
adb shell am broadcast -a android.intent.action.AIRPLANE_MODE --ez state true
```

Либо просто выключите Wi-Fi и мобильные данные в шторке уведомлений. Параллельно смотрите логи приложения:

```bash
adb logcat --pid=$(adb shell pidof <package.name>)
```

Имя пакета (уникальный идентификатор приложения вида `com.vendor.app`) возьмите с экрана «О приложении» в настройках Android или командой:

```bash
adb shell pm list packages | grep -i aether
```

**Зачем:** авиарежим — единственный честный тест «локальности». Если ответ приходит без сети, модель действительно работает на устройстве, а не отправляет запрос на сервер.

**Как проверить:** на экране появляется текст ответа, в логах нет сетевых ошибок вида `UnknownHostException`, а в шторке горит значок самолёта.

**Пример:** в авиарежиме вы просите агента выполнить `ls /sdcard/Download` — он возвращает список файлов, включая `models`. Это одновременно проверяет и bash, и офлайн-модель.

Если приложение ведёт себя иначе (например, требует сеть при первом старте), сверьтесь с документацией Aether: там указано, нужен ли однократный онлайн-вход.

Как устроены похожие офлайн-ассистенты на Android и чем они отличаются по поведению, разобрано в обзоре [Локальные ИИ-компаньоны для Android: обзор приложений для офлайн-общения с LLM](https://ai-release.org/guides/lokalnye-ii-kompanony-dlya-android-obzor-prilozheniy-dl.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide), а базовый сценарий установки такого агента — в гайде [ИИ-агент прямо на смартфоне: как установить и пользоваться офлайн-ассистентом](https://ai-release.org/guides/ii-agent-pryamo-na-smartfone-kak-ustanovit-i-polzovatsy.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).

Финальный чек-лист:

- [ ] `adb devices` показывает `device`
- [ ] `adb install` вернул `Success`
- [ ] файл модели виден в `/sdcard/Download/models/`
- [ ] в приложении модель в статусе «загружено»
- [ ] `echo "bash ok"` в терминале Aether печатает `bash ok`
- [ ] в авиарежиме ответ приходит

## Возможные проблемы и решения

**Проблема. Установка прерывается на середине, хотя места хватает**
- Ошибка: `adb: failed to install Aether.apk: Failure [INSTALL_FAILED_UPDATE_INCOMPATIBLE: Package ... signatures do not match previously installed version; ignoring!]`
- Причина: на телефоне уже стоит сборка Aether с другой подписью (например, вы ранее ставили APK из стороннего источника).
- Решение: удалите старую версию и поставьте заново — данные приложения будут потеряны:
```bash
adb uninstall <package.name>
adb install "/путь/к/Aether.apk"
```

**Проблема. ADB не видит телефон**
- Ошибка: `error: no devices/emulators found` или строка `R58M12ABCDE	unauthorized` в выводе `adb devices`
- Причина: не запущен ADB-сервер, кабель только для зарядки, выбран режим «Только зарядка» или не подтверждён ключ на экране телефона.
- Решение: перезапустите сервер, переподключите кабель, выберите «Передача файлов» и подтвердите окно отладки:
```bash
adb kill-server
adb start-server
adb devices
```

**Проблема. Приложение закрывается при загрузке модели**
- Ошибка: в логах `java.lang.OutOfMemoryError` или `Failure [INSTALL_FAILED_INSUFFICIENT_STORAGE]` на этапе установки
- Причина: модель больше доступной приложению памяти либо файл скопирован не полностью (обрыв `adb push`, недокачанный файл).
- Решение: сравните размер файла на ПК и на телефоне, при расхождении скопируйте заново, затем возьмите модель меньшего размера и закройте фоновые приложения:
```bash
adb shell ls -l /sdcard/Download/models/
```

## Резюме и следующие шаги
Вы получили на телефоне локального агента: APK установлен через ADB, файл модели лежит в памяти устройства, bash-команды выполняются, а ответы приходят в авиарежиме. Дальше имеет смысл проверить, как Aether ведёт себя на длинных задачах (несколько команд подряд), и сверить с документацией список поддерживаемых форматов моделей, чтобы заменить файл на более подходящий.

## FAQ

**Нужен ли root для установки Aether?**
Нет. Установка через `adb install`, копирование файла в `/sdcard/Download/` и проверка в авиарежиме выполняются без root. Нужен ли root для отдельных системных операций внутри bash-терминала, сверьтесь с документацией проекта.

**Можно ли установить Aether без компьютера?**
Да: скачайте APK прямо на телефон, разрешите установку из этого источника в настройках и откройте файл. Проверка файла перед установкой описана в [гайде по WordCraft APK](https://ai-release.org/guides/wordcraft-apk-android-skachat.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide). Минус способа — файл модели всё равно придётся скачивать на устройство.

**Почему приложение не видит файл модели?**
Чаще всего файл лежит в приватной папке другого приложения или в кэше загрузок, к которому нет доступа по выбранному пути. Положите модель в общую память (`/sdcard/Download/models/`) и укажите эту папку заново.

**Работает ли агент полностью без интернета?**
Да, после того как модель загружена на устройство: запросы обрабатываются локально. Требуется ли однократный онлайн-вход при первом запуске — сверьтесь с документацией Aether.
