Как запустить ИИ-агента на Android: пошагово
Ниже инструкция для Aether — открытого агента для Android. Она же подойдёт как общий план для любого приложения такого типа: сначала установка, потом модель, потом инструменты, и только в конце среда и расширения. По времени — минут десять, если ключ от провайдера уже есть.
Скачать APK ИсходникиЧто понадобится
- Телефон с Android 8.0 или новее, свободных ~200 МБ.
- APK из раздела Releases. Сборки подписаны одним ключом, поэтому обновления ставятся поверх.
- API-ключ провайдера модели: OpenAI, Anthropic через совместимый шлюз, OpenRouter, либо локальный сервер (LM Studio, Ollama, llama.cpp) в домашней сети.
Шаг 1. Установка
Скачайте последний APK и откройте файл. Android спросит разрешение на установку из этого источника — включите для файлового менеджера или браузера, которым открывали, и вернитесь назад. Дальше обычное «Установить».
Если система пишет «Приложение не установлено», причин ровно три: скачался битый файл, на телефоне уже стоит сборка с другой подписью, или versionCode меньше установленного. Лечится так: удалить старую версию (данные при этом потеряются) и поставить релизную. Именно поэтому я не меняю подпись и не откатываю versionCode.
Шаг 2. Подключение модели
Откройте настройки, раздел с провайдерами. Нужны три поля: адрес API, ключ, имя модели.
- Облако: адрес вида
https://api.openai.com/v1(или адрес вашего шлюза), ключ из личного кабинета, модель вродеgpt-4o-mini. - Локально: поднимите LM Studio или Ollama на компьютере, включите доступ по сети и укажите адрес компьютера с портом, например
http://192.168.1.10:1234/v1. Ключ обычно любой непустой.
После сохранения в чате появится чип модели над полем ввода. Если ответа нет — почти всегда дело в адресе: нужен именно суффикс /v1 и доступность порта с телефона.
Шаг 3. Первый запрос
Начните с чего-то проверяемого: «посмотри список файлов в рабочей папке и скажи, что там». Агент вызовет инструмент, покажет карточку с командой и результатом, потом ответит текстом. Опасные действия — bash, write, edit — требуют подтверждения: это не формальность, а страховка от «удали всё в проекте».
Шаг 4. Среда выполнения
Есть два варианта. Встроенная Alpine запускается через proot: без root, без разблокировки загрузчика, старт около двух секунд. Пакеты ставятся через apk add, состояние сохраняется между запусками.
Второй вариант — подключить Termux, если он уже настроен. Тогда агент видит ваши пакеты, конфиги и git-репозитории, и ничего не надо ставить дважды. Переключение — в настройках среды.
Шаг 5. Расширения и MCP
MCP-серверы подключаются по stdio: указываете команду запуска и аргументы, Aether поднимает процесс и получает список инструментов. Так к агенту добавляются поиск в интернете, работа с базами, доступ к заметкам и что угодно ещё, для чего уже написан сервер. Расширения — то же самое, но на уровне приложения: новые инструменты, команды и хуки.
Типичные ошибки
Ответ обрывается на середине
Android убил фоновый процесс. Держите уведомление агента активным и отключите оптимизацию батареи для приложения.
Терминал тормозит
proot — это эмуляция, а не виртуализация. Тяжёлые сборки лучше гонять в Termux или на компьютере, а на телефоне — короткие команды и правки.
Модель «не видит» файл
Проверьте, в какой среде работает сессия: Alpine и Termux — разные файловые системы, пути в них не совпадают.
Вопросы, которые задают чаще всего
Нужен ли root? Нет. Всё работает в песочнице приложения.
Можно ли без интернета? Да, если модель локальная: приложение ходит на любой совместимый адрес, включая LM Studio и Ollama.
Сколько стоит? Приложение бесплатное, открытое под GPL-3.0. Платите только за токены провайдеру, если он платный.
Есть ли управление телефоном? Нет и не планируется: агент не нажимает по экрану и не читает другие приложения.
Aether — открытый проект. Исходники: github.com/aether-aiagent/aether. Другие страницы: ИИ-агент на телефон, AI-агент для Android, локальная модель на Android, Termux и ИИ.