Перейти к основному содержимому

VibeOS на Android с Termux

Платформа второго уровня

Termux (Android) — это платформа второго уровня. Сценарий установки и документация поддерживаются по принципу «best-effort». Коммиты в main могут в любой момент нарушить работу этих пакетов.

VibeOS может работать напрямую на Android-телефоне через Termux.

Это даёт рабочий локальный CLI на телефоне, а также основные дополнительные компоненты, которые, как известно, чисто устанавливаются на Android.

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

Проверенный пакет Termux устанавливает:

  • CLI VibeOS
  • поддержку cron
  • поддержку PTY/фонового терминала
  • поддержку шлюза Telegram (ручной запуск / фоновый режим best-effort)
  • поддержку MCP
  • поддержку памяти Honcho
  • поддержку ACP

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

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

Что пока не входит в проверенный путь?​

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

  • .[all] не поддерживается на Android на данный момент
  • расширение voice заблокировано из-за faster-whisper -> ctranslate2, а ctranslate2 не публикует сборки для Android
  • автоматическая загрузка браузера / Playwright пропускается в установщике Termux
  • изоляция терминала на основе Docker недоступна внутри Termux
  • Android может приостанавливать фоновые задачи Termux, поэтому постоянство шлюза обеспечивается по принципу best-effort, а не как обычный управляемый сервис

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

Вариант 1: Установка одной командой​

VibeOS теперь поставляется с установщиком, учитывающим особенности Termux:

curl -fsSL https://vibeos.com.ru/downloads/install.sh | bash

В Termux установщик автоматически:

  • использует pkg для системных пакетов
  • создаёт виртуальное окружение с помощью python -m venv
  • сначала пытается установить расширение .[termux-all], а при неудаче переходит к меньшему .[termux] (затем к базовой установке) — установщик curl автоматически соблюдает этот порядок
  • создаёт ссылку vibeos в $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 — среда выполнения + поддержка виртуального окружения
  • git — клонирование/обновление репозитория
  • clang, rust, make, pkg-config, libffi, openssl — необходимы для сборки некоторых зависимостей Python на Android
  • nodejs — опциональная среда выполнения Node для экспериментов за пределами проверенного основного пути
  • ripgrep — быстрый поиск файлов
  • ffmpeg — преобразование медиа / TTS

2. Клонируйте VibeOS​

git clone https://github.com/Linx72/VibeOS.git
cd vibeos

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. Добавьте vibeos в PATH Termux​

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

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

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

vibeos version
vibeos doctor

7. Запустите VibeOS​

vibeos

Рекомендуемая дальнейшая настройка​

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

vibeos model

Или установите ключи напрямую в ~/.vibeos/.env.

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

vibeos setup

Установка опциональных зависимостей Node вручную​

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

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 со стандартным виртуальным окружением и 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

vibeos 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

Обновление в Termux​

На телефоне нет APK и нет установщиков Windows/macOS. Обновление — тот же git/CLI путь, что и у source-install:

vibeos update --check   # отставание от git + подсказка версии Desktop с CDN
vibeos update           # pull + зависимости; ~/.vibeos не сносится
  • Не скачивайте VibeOS-Setup.exe / Mac DMG с vibeos.com.ru/download внутри Termux — это оболочки Desktop для Windows/macOS.
  • На странице загрузки Termux всё равно указан; для телефона правильный вход — one-liner установки выше.
  • После публикации Desktop-релиза на Timeweb vibeos update --check может показать версию с CDN (latest.json → блоки cli / android). Это подсказка — ставить обновление нужно через vibeos update, а не через .exe / .dmg.

Полная матрица: Обновление и удаление.

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

  • Бэкенд Docker недоступен
  • локальное распознавание голоса через faster-whisper недоступно в проверенном пути
  • автоматическая настройка браузера намеренно пропускается установщиком
  • некоторые опциональные расширения могут работать, но в настоящее время только .[termux] и .[termux-all] задокументированы как проверенные пакеты для Android
  • APK / Google Play пока нет — обновляйтесь через vibeos update (git), не через Desktop-установщики

Если вы столкнулись с новой проблемой, специфичной для Android, пожалуйста, откройте issue на GitHub с:

  • версией вашего Android
  • termux-info
  • python --version
  • vibeos doctor
  • точной командой установки и полным выводом ошибки