Урок 2. Установка HAPI#

Зачем это нужно#

Прежде чем управлять AI-агентами с телефона, нужно установить HAPI на компьютер. Хорошая новость: это делается одной командой. В этом уроке мы пройдём весь процесс от начала до конца.

Что нужно для установки#

1. Компьютер с macOS, Linux или Windows#

HAPI работает на любой из этих систем. Подойдёт обычный ноутбук или настольный компьютер.

2. Node.js (версия 18 или новее)#

Node.js — это платформа, которая позволяет запускать программы на JavaScript. HAPI написан на JavaScript, поэтому ему нужен Node.js.

Как проверить, установлен ли Node.js:

Откройте терминал и введите:

node --version

Если увидите что-то вроде v22.22.0 — всё в порядке. Если команда не найдена — нужно установить.

Как открыть терминал:

• macOS: найдите «Terminal» через Spotlight (Cmd + Пробел) или в Программы → Утилиты
• Windows: найдите «PowerShell» или «Командная строка» в меню Пуск
• Linux: обычно Ctrl + Alt + T

Как установить Node.js:

1. Перейдите на сайт nodejs.org
2. Скачайте версию LTS (Long Term Support — стабильная версия)
3. Запустите установщик и следуйте инструкциям

💡 Альтернатива: вместо Node.js можно использовать Bun — более быстрый аналог. Скачать его можно на bun.sh. Но для начинающих рекомендуем Node.js — он более распространён.

3. AI-агент (хотя бы один)#

HAPI — это обёртка над AI-агентами. Поэтому нужен хотя бы один из них:

# Проверить Claude Code
claude --version

# Проверить Codex
codex --version

# Проверить Gemini
gemini --version

Если у вас ещё нет AI-агента, самый популярный вариант — Claude Code:

npm install -g @anthropic-ai/claude-code

Установка HAPI#

Есть несколько способов. Выберите тот, что вам удобнее.

Способ 1: npx (без установки) — самый простой#

npx — это утилита, которая идёт вместе с Node.js. Она скачивает и запускает программу одной командой, не устанавливая её «навсегда».

npx @twsxtd/hapi

Этот способ хорош для первого знакомства. Каждый раз npx будет проверять обновления.

Способ 2: Глобальная установка через npm#

npm (Node Package Manager) — менеджер пакетов, который тоже идёт вместе с Node.js. Глобальная установка означает, что программа будет доступна из любой папки.

npm install -g @twsxtd/hapi

После этого можно просто писать hapi вместо npx @twsxtd/hapi.

Способ 3: Homebrew (только macOS и Linux)#

Homebrew — это популярный менеджер пакетов для macOS. Если он у вас установлен:

brew install tiann/tap/hapi

Проверяем установку#

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

hapi --help

Если всё прошло успешно, вы увидите список доступных команд.

Что создаётся при первом запуске#

Когда вы впервые запустите HAPI, он создаст папку ~/.hapi/ с конфигурацией:

~/.hapi/
├── settings.json      # Настройки (токен доступа, адреса)
├── hapi.db           # База данных (хранит сессии)
└── logs/             # Логи (журнал работы)

💡 Символ ~ означает вашу домашнюю папку. На macOS это /Users/ваше_имя/, на Linux — /home/ваше_имя/.

Системные требования#

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

«command not found: node»#

Node.js не установлен. Перейдите на nodejs.org и установите.

«permission denied» при установке#

На macOS/Linux попробуйте:

sudo npm install -g @twsxtd/hapi

sudo — это команда, которая запускает следующую команду с правами администратора. Система попросит ваш пароль.

«EACCES» ошибка#

Это тоже проблема с правами. Лучшее решение — настроить npm для работы без sudo:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

После этого повторите установку без sudo.

Итоги урока#

• Для HAPI нужен Node.js (версия 18+) и хотя бы один AI-агент
• Самый простой способ попробовать: npx @twsxtd/hapi
• Для постоянного использования: npm install -g @twsxtd/hapi
• При первом запуске HAPI создаёт папку ~/.hapi/ с настройками
• Если что-то не работает — проверьте версию Node.js и права доступа

В следующем уроке мы запустим HAPI и подключимся к нему с телефона.