Что такое HeyAgent и почему это важно
HeyAgent позиционируется как local-first десктопный агент, который выходит за рамки простого чата. В отличие от большинства AI-ассистентов, ограниченных песочницами, HeyAgent получает прямой доступ к операционной системе: управляет мышью, клавиатурой, окнами, браузерами и файловой системой. Ключевая особенность — работа с реальными профилями браузеров (Chrome, Edge, Yandex Browser) и интеграция с Google Workspace без необходимости облачной обработки данных.
Проект ориентирован на русскоязычных пользователей, поддерживая опечатки в запросах, но полностью совместим с английским языком. Управление осуществляется через терминал, десктопное приложение или удаленно через Telegram-бота с телефона.
Ключевые возможности и интеграции
Агент использует детерминированную оркестрацию (маршрутизация → планирование → выполнение → верификация), что повышает надежность сложных задач. Поддерживается выбор между облачными провайдерами (OpenRouter, AWS Bedrock) и локальными моделями через Ollama. Для голосовых ответов используется ElevenLabs с автоматическим падением в текстовый режим при сбоях.
| Компонент | Возможности HeyAgent | Требуемый API / Сервис |
|---|---|---|
| Google Drive | Поиск и управление файлами | Google Drive API |
| Google Docs | Создание и чтение документов | Google Docs API |
| Google Sheets | Создание и форматирование таблиц | Google Sheets API |
| Google Slides | Создание презентаций | Google Slides API |
| Google Calendar | Чтение событий календаря | Google Calendar API |
| Telegram | Удаленное управление ПК, переписка | Telegram Bot API + Telegram Desktop |
Технические требования и установка
Для работы требуется Node.js 22+ и npm. Поддержка ОС: Windows 10/11 (рекомендуется для полного контроля десктопа), macOS, Linux. На macOS/Linux необходимо установить дополнительные утилиты (cliclick, xdotool, wmctrl и др.).
Быстрый старт включает клонирование репозитория, установку зависимостей и инициализацию агента:
git cloneиnpm installnpx hey onboard— настройка личности, аватара и языкаnpx hey models set ollama/llama3.2— выбор локальной моделиnpx hey gateway start— запуск локального API (порт 28789)
Безопасность и архитектура
Поскольку HeyAgent взаимодействует с реальным десктопом и браузерами, автор подчеркивает важность модели безопасности. Пользователям рекомендуется тщательно настраивать разрешения. Для Telegram-интеграции требуется привязка бота к конкретному чату (npx hey telegram pair), чтобы исключить несанкционированный доступ со стороны других пользователей бота. Все учетные данные (токены API, OAuth) хранятся локально.
Источник: Github ↗