🏠 Главная › Getting Started › termux

sidebar_position: 3 title: "Android / Termux" description: "Run Hermes Agent directly on an Android phone with Termux" lang: ru

Гермес на Android с помощью Termux

Это проверенный способ запуска агента Hermes непосредственно на телефоне Android через Termux.

Он дает вам работающий локальный интерфейс командной строки на телефоне, а также основные дополнительные функции, которые, как известно, можно без проблем установить на Android.

Что поддерживается в тестируемом пути?

Тестируемый пакет Termux устанавливает: - интерфейс командной строки Гермеса - поддержка cron - Поддержка PTY/фонового терминала - Поддержка шлюза Telegram (ручной/фоновый запуск с максимальными усилиями) - Поддержка МКП - Поддержка памяти Honcho - поддержка АКП

Конкретно это соответствует:

python -m pip install -e '.[termux]' -c constraints-termux.txt

Что еще не входит в тестируемый путь?

Некоторым функциям по-прежнему требуются зависимости в стиле настольного компьютера/сервера, которые не опубликованы для Android или еще не проверены на телефонах:

Это не мешает Hermes хорошо работать в качестве агента CLI для телефона — это просто означает, что рекомендуемая мобильная установка намеренно уже, чем установка на настольном компьютере или сервере.

Вариант 1: Однострочный установщик

Hermes теперь предоставляет путь установки с поддержкой Termux:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

В Termux установщик автоматически: - использует pkg для системных пакетов - создает венв с помощью python -m venv - устанавливает .[termux] с pip - связывает hermes с $PREFIX/bin, чтобы он оставался в вашем PATH Termux - пропускает непроверенную загрузку браузера/WhatsApp

Если вам нужны явные команды или вам нужно отладить неудачную установку, используйте указанный ниже путь вручную.

Вариант 2: установка вручную (полностью явная)

1. Обновите Termux и установите системные пакеты.

pkg update
pkg install -y git python clang rust make pkg-config libffi openssl nodejs ripgrep ffmpeg

Зачем эти пакеты? - python — среда выполнения + поддержка venv - git — клонировать/обновить репозиторий - clang, rust, make, pkg-config, libffi, openssl — необходимо для создания нескольких зависимостей Python на Android. - nodejs — дополнительная среда выполнения Node для экспериментов за пределами тестируемого основного пути. - ripgrep — быстрый поиск файлов - ffmpeg — медиа/TTS-преобразования

2. Клон Гермеса

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

Если вы уже клонировали без подмодулей:

git submodule update --init --recursive

3. Создайте виртуальную среду

python -m venv venv
source venv/bin/activate
export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install --upgrade pip setuptools wheel

ANDROID_API_LEVEL важен для пакетов на основе Rust/maturin, таких как jiter.

4. Установите проверенный пакет Termux.

python -m pip install -e '.[termux]' -c constraints-termux.txt

Если вам нужен только минимальный основной агент, это также работает:

python -m pip install -e '.' -c constraints-termux.txt

5. Поместите hermes в свой PATH Termux.

ln -sf "$PWD/venv/bin/hermes" "$PREFIX/bin/hermes"

$PREFIX/bin уже находится в PATH в Termux, поэтому команда hermes сохраняется в новых оболочках без повторной активации venv каждый раз.

6. Проверьте установку

hermes version
hermes doctor

7. Запустите Гермес

hermes

Рекомендуемая настройка последующего наблюдения

Настройка модели

hermes model

Или задайте ключи прямо в ~/.hermes/.env.

Повторно запустите мастер полной интерактивной настройки позже

hermes setup

Установите дополнительные зависимости узла вручную

Протестированный путь Termux намеренно пропускает загрузку узла/браузера. Если вы захотите поэкспериментировать с инструментами браузера позже:

pkg install nodejs-lts
npm install

Инструмент браузера автоматически включает каталоги Termux (/data/data/com.termux/files/usr/bin) в поиск по PATH, поэтому agent-browser и npx обнаруживаются без какой-либо дополнительной настройки PATH.

Считайте инструменты браузера и WhatsApp на Android экспериментальными, пока не будет указано иное.

Устранение неполадок

No solution found при установке .[all]

Вместо этого используйте протестированный пакет Termux:

python -m pip install -e '.[termux]' -c constraints-termux.txt

В настоящее время блокировщиком является дополнение voice: - voice тянет faster-whisper - faster-whisper зависит от ctranslate2 - ctranslate2 не публикует колеса Android

uv pip install не работает на Android

Вместо этого используйте путь Termux с stdlib venv + pip:

python -m venv venv
source venv/bin/activate
export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install --upgrade pip setuptools wheel
python -m pip install -e '.[termux]' -c constraints-termux.txt

jiter / maturin жалуется на ANDROID_API_LEVEL

Перед установкой явно установите уровень API:

export ANDROID_API_LEVEL="$(getprop ro.build.version.sdk)"
python -m pip install -e '.[termux]' -c constraints-termux.txt

hermes doctor говорит, что ripgrep или Node отсутствуют

Установите их с помощью пакетов Termux:

pkg install ripgrep nodejs

Сбои сборки при установке пакетов Python

Убедитесь, что набор инструментов сборки установлен:

pkg install clang rust make pkg-config libffi openssl

Затем повторите попытку:

python -m pip install -e '.[termux]' -c constraints-termux.txt

Известные ограничения на телефонах

Если вы столкнулись с новой проблемой, специфичной для Android, откройте проблему на GitHub с помощью: - ваша версия Android - termux-info - python --version - hermes doctor - точная команда установки и полный вывод ошибок