Урок 1. Что такое HAPI и зачем он нужен#

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

Представьте: вы работаете с AI-помощником (например, Claude Code) на компьютере. Он пишет код, редактирует файлы, выполняет команды. Но вам нужно отойти — выпить кофе, поехать на встречу, просто прогуляться. Без HAPI ваш AI-агент остановится и будет ждать вас у компьютера. С HAPI вы достаёте телефон и продолжаете работу прямо с него — без потери прогресса.

HAPI — это инструмент, который позволяет управлять AI-агентами удалённо: с телефона, планшета или любого браузера.

Что такое AI-агент?#

AI-агент — это программа с искусственным интеллектом, которая умеет выполнять задачи на вашем компьютере. Например:

Claude Code (от Anthropic) — пишет и редактирует код
Codex (от OpenAI) — тоже помогает с кодом
Gemini CLI (от Google) — ещё один AI-помощник
OpenCode — открытый аналог

Все они работают в терминале (командной строке) вашего компьютера. HAPI не заменяет их, а «оборачивает» — добавляет возможность управлять ими удалённо.

Главная фишка: Seamless Handoff#

Seamless Handoff (бесшовное переключение) — это возможность переключаться между компьютером и телефоном без потери контекста.

Как это работает:

Вы работаете с AI-агентом в терминале на компьютере
Отправляете сообщение с телефона — управление автоматически переходит на телефон
В терминале появляется надпись «Remote mode — waiting for input» (Удалённый режим — ожидание ввода)
Возвращаетесь к компьютеру, нажимаете двойной пробел — и снова работаете локально

Никаких перезапусков, никакой потери данных. Один и тот же сеанс, одно и то же состояние.

Чем HAPI отличается от Happy?#

HAPI вдохновлён проектом Happy, но устроен принципиально по-другому:

	Happy	HAPI
Где хранятся данные	На облачном сервере (зашифрованы)	На вашем компьютере
Архитектура	Централизованная — один сервер для всех	Децентрализованная — каждый запускает свой hub
Что делает сервер	Хранит ваши зашифрованные данные	Relay только передаёт трафик, ничего не хранит
Установка	Несколько сервисов (база данных, кеш, сервер)	Одна команда

Проще говоря:

Happy — это как Gmail: ваши письма лежат на серверах Google (зашифрованные, но всё-таки там).
HAPI — это как свой почтовый сервер: всё на вашей машине, а «почтальон» (relay) только передаёт конверты, не заглядывая внутрь.

Что такое Hub и Relay?#

Hub (хаб) — это «центр управления», который работает на вашем компьютере. Он хранит сессии, управляет подключениями и даёт доступ к веб-интерфейсу.
Relay (ретранслятор) — это промежуточный сервер, который просто пересылает зашифрованный трафик между вашим телефоном и компьютером. Он не может прочитать ваши данные — они зашифрованы с помощью WireGuard + TLS (технологии шифрования военного уровня).

Что умеет HAPI#

📱 Управление с телефона — отправляйте команды AI-агенту откуда угодно
✅ Одобрение запросов — AI хочет отредактировать файл? Одобрите одним нажатием с телефона
🔄 Бесшовное переключение — компьютер ↔ телефон без потери прогресса
🤖 Любой AI на выбор — Claude Code, Codex, Gemini, OpenCode
🖥️ Терминал везде — запускайте команды прямо с телефона
🎤 Голосовое управление — разговаривайте с AI-агентом голосом
🔒 Безопасность — данные не покидают ваш компьютер

Итоги урока#

HAPI — инструмент для удалённого управления AI-агентами с телефона и браузера
Главная функция — Seamless Handoff: переключение между устройствами без потери контекста
В отличие от Happy, HAPI децентрализован: данные остаются на вашем компьютере
Relay только передаёт зашифрованный трафик — он не видит ваших данных
HAPI поддерживает Claude Code, Codex, Gemini и OpenCode

В следующем уроке мы установим HAPI на ваш компьютер.