2026: самое полное руководство по установке и настройке OpenHuman — пошаговый tutorial от нуля до запуска

2. Не установите не тот проект: настольный ассистент и WebGL SDK

OpenHuman (это руководство) — open-source настольный личный AI-ассистент tinyhumansai/openhuman: UI-first, Memory Tree, Markdown vault в стиле Obsidian, 118+ OAuth-интеграций, опциональный локальный Ollama. По умолчанию всё ещё используются хостинговые сервисы OpenHuman для входа, маршрутизации моделей, прокси поиска и OAuth через слой Composio (постепенно можно перейти на BYOK / прямой Composio в настройках).

В сети есть и OpenHuman WebGL SDK цифрового человека — для веб-3D-аватаров, не для установки по этому гиду. Если цель — «личная база знаний + контекст почты/календаря/репозиториев», берите настольный репозиторий и страницу загрузки tinyhumans.ai/openhuman.

Это также не обычная вкладка веб-чата: OpenHuman делает упор на локальные рабочие данные + плановую подтяжку интеграций, а не на разовое окно браузера. В отличие от CLI-first агентов, здесь графический UI + короткий onboarding — конфиг до первого сообщения не обязателен.

3. Типичные ловушки

1. Ограничение: «установлено» = «уже понимает меня». Официальная документация: Memory Tree, Markdown vault, конфиг workspace и локальное состояние runtime хранятся на вашей машине; вход, маршрутизация моделей, прокси поиска и OAuth по умолчанию могут идти через хостинг. Без подключённых интеграций и завершённой синхронизации агент говорит только общими фразами.
2. Скрытая цена: слишком широкие права и боевые аккаунты в первый день. Один OAuth может охватить почту, календарь, репозитории и др. Пока продукт в Beta, начните с тестового ящика или тестового GitHub-репо, проверьте scopes и путь отзыва, затем подключайте реальные данные.
3. Стабильность и аудит: неизвестно, где лежат память и логи. Переустановка без заметок может стереть единственный след SQLite и vault. Зафиксируйте путь workspace, ID интеграций и режим модели (hosted / BYOK / Ollama) для отката.

4. Чек-лист перед установкой

Цель: обнаружить проблемы сети или диска на полпути — потеря часов. Критерий успеха: все пункты ниже отмечены до загрузки.

• ОС: macOS (Apple Silicon или Intel), Windows 10/11 (64-bit), Debian/Ubuntu или Arch Linux desktop. Минимальные версии — по текущим Release notes; продукт помечен Early Beta — пути в UI могут меняться.
• Железо: рекомендуется 16 ГБ+ ОЗУ (локальный Ollama — больше); зарезервируйте ≥5 ГБ диска (приложение + vault + SQLite + кэш моделей — фактическое потребление варьируется).
• Сеть: доступ к GitHub, tinyhumans.ai и доменам OAuth-редиректа; за корпоративным прокси — системный прокси или разрешение всплывающих окон браузера.
• Аккаунты: аккаунт продукта OpenHuman; при необходимости API keys BYOK от вендоров моделей; установленный Ollama и скачанная модель для локального inference.
• Тестовые данные: отдельный тестовый Gmail / тестовый GitHub-репозиторий — не подключайте корпоративный Slack или боевой ящик при первом запуске.
• Права: macOS может запросить уведомления, микрофон (голос) и доступ к файлам/папкам; на Linux учтите известные проблемы AppImage + Wayland (официальный issue #2463).

5. Источники загрузки и проверка безопасности

Официальный приоритет (README): ① Сайт / установщики GitHub Release → ② Нативные пакетные менеджеры (Homebrew, подписанный apt, MSI) → ③ Скрипт установки (отдельной подписи скрипта нет — только если понимаете риск).

Сначала при сбое: повреждённый файл → перекачать с Release; блок SmartScreen / Gatekeeper → подтвердить издателя и разрешить; не подменяйте официальные пакеты неизвестными «зеркалами».

6. Установка на трёх платформах

6.1 macOS (рекомендуется Homebrew)

brew tap tinyhumansai/core
brew install openhuman

Альтернатива: скачать .dmg с Release и перетащить в «Программы». Критерий успеха: OpenHuman открывается из Launchpad. Сначала при сбое: «невозможно проверить разработчика» → Системные настройки → Конфиденциальность и безопасность → Всё равно открыть; при первом запуске разрешите уведомления/микрофон/файлы (минимум для нужных функций).

6.2 Windows (подписанный MSI)

Скачайте .msi с последнего release и запустите установщик. В SmartScreen подтвердите издателя. Критерий успеха: ярлык в меню «Пуск» запускает приложение. Сначала при сбое: корпоративная политика, карантин антивируса, файрвол блокирует OAuth-callback браузера.

6.3 Linux (рекомендуется apt; AppImage с осторожностью)

sudo apt-get install -y --no-install-recommends gnupg2 curl ca-certificates
curl -fsSL https://tinyhumansai.github.io/openhuman/apt/KEY.gpg \
  | sudo gpg --dearmor -o /etc/apt/keyrings/openhuman.gpg
echo "deb [signed-by=/etc/apt/keyrings/openhuman.gpg arch=amd64] \
  https://tinyhumansai.github.io/openhuman/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/openhuman.list
sudo apt-get update
sudo apt-get install -y openhuman

Пользователи Arch могут попробовать рецепт AUR openhuman-bin (yay -S openhuman-bin — сверьте листинг AUR). AppImage может падать на Wayland или части Arch (официальный issue #2463); на Debian/Ubuntu предпочтительны .deb / apt. Критерий успеха: приложение запускается из меню рабочего стола. Сначала при сбое: недостающие библиотеки, переменные Wayland, сессия X11.

6.4 Матрица выбора способа установки

Удаление и переустановка: сначала отключите все OAuth-интеграции и сделайте бэкап нужных каталогов vault; после удаления workspace и SQLite могут остаться в профиле пользователя — уточните официальные пути данных, прежде чем удалить единственную копию памяти.

7. Первый запуск и вход в аккаунт

1. Запустите приложение и выберите отдельный каталог workspace — не указывайте весь домашний каталог.
2. Войдите с аккаунтом продукта OpenHuman (стандартный хостинговый поток входа). Критерий успеха: в настройках виден вход.
3. Просмотрите канал обновлений и переключатели приватности (уведомления, голос, прокси поиска) — до прохождения первого цикла оставьте по умолчанию, затем настройте.

Сначала при сбое: пустая страница входа → другой браузер по умолчанию, отключите блокировщики рекламы; повторные сбои → время системы, DNS, прокси; региональные и подписочные политики — по актуальной официальной документации; это руководство не обещает одинаковый набор функций во всех регионах.

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

Хостинговые модели (по умолчанию): бэкенд OpenHuman выполняет маршрутизацию моделей (выбор reasoning/fast/vision под задачу). В официальных формулировках — мультимодельная маршрутизация в рамках подписки; цены и квоты на странице аккаунта могут меняться.

BYOK (Bring Your Own Key — свой ключ): введите API keys вендоров в настройках — вы платите за использование и управляете квотами; удобно при корпоративных контрактах или точном контроле расходов.

Локальные модели (Ollama): официальная документация поддерживает опциональный локальный AI; унифицированная память Apple Silicon помогает с небольшими моделями, но крупные всё равно упираются в ОЗУ — проверьте задержку и качество сами.

Критерий успеха: отправьте тестовый запрос (например: «Представься одним предложением») и получите связный ответ. Сначала при сбое: hosted → подписка/сеть; BYOK → права ключа и биллинг; Ollama → сервис слушает порт и имя модели совпадает.

9. Интеграции и настройка прав

OpenHuman подключает Gmail, Slack, Notion, GitHub, Calendar, Drive и 118+ коннекторов через слой Composio. OAuth и вызовы инструментов по умолчанию проксируются через хостинговый бэкенд; для прямого Composio добавьте свой Composio API key в настройках и разместите webhook-триггеры в реальном времени сами.

OAuth — стандартный поток «войти через браузер и выдать приложению ограниченный доступ от вашего имени». Читайте области доступа (scopes) на экране согласия — выдавайте только то, что нужно практическому кейсу; непонятный scope пока не подтверждайте.

Критерий успеха: интеграция в статусе Connected, OAuth-callback без ошибки. Сначала при сбое: заблокированные всплывающие окна, корпоративный SSO, статус Composio, сетевой прокси.

10. Как принять систему памяти

Для новичков память OpenHuman устроена так:

• Memory Tree: организует данные интеграций в иерархические сводки локально в SQLite для поиска агентом.
• Markdown vault (совместим с Obsidian): те же знания попадают в файлы .md, которые можно просматривать и править в Obsidian.
• auto-fetch: каждое активное подключение подтягивает новые данные примерно каждые 20 минут — отдельный скрипт опроса не нужен.

Шаги приёмки: подключить тестовую интеграцию → подождать минимум один 20-минутный цикл (или ручной триггер, если есть в UI) → проверить Memory или vault на новые Markdown-блоки → задать вопрос, на который ответят только тестовые данные (например, уникальное слово из тестового письма).

Критерий успеха: ответ ссылается на верные источники или фрагменты файлов. Сначала при сбое: неактивная интеграция, незавершённая синхронизация или вопрос о боевых данных при подключённом только тестовом источнике (галлюцинация «пустого контекста»).

11. Первый практический кейс: тестовый ящик «недельное резюме + список дел»

Цель: за один проход проверить модель, интеграцию, память, вывод и цикл отзыва доступа.

1. Создайте тестовый Gmail; отправьте себе 2–3 письма с понятными темами (например: «Обсуждение бюджета Q2», «Сдать недельный отчёт до пятницы»).
2. В OpenHuman подключите только этот тестовый ящик; завершите OAuth.
3. Дождитесь первого auto-fetch (рекомендуется ≥20 минут); убедитесь, что в vault / Memory появился новый контент.
4. Спросите: «По недавней почте в моём тестовом ящике составь недельное резюме и список дел, укажи, из какого письма каждый пункт».
5. Проверьте: резюме совпадает с тестовой почтой; нет выдуманных тем; сохраните экспорт, если приложение поддерживает.
6. Отзовите авторизацию в OpenHuman и Google; убедитесь, что после Disconnect агент не ссылается на этот ящик.

Критерий успеха: вывод совпадает с тестовой почтой, источники проверяемы, после отзыва доступ прекращается. Сначала при сбое: разделяйте слой модели (④) и слой памяти (⑥) — не смешивайте диагностику.

12. Частые проблемы (послойная диагностика)

13. Чек-лист после настройки: расширяйте, когда цикл стабилен

• Отзовите тестовый OAuth, затем добавляйте реальный ящик/репо по одной интеграции.
• Сделайте бэкап workspace, vault и скриншотов ключевых настроек; зафиксируйте режим модели и примерную месячную стоимость.
• Прочитайте официальный раздел Privacy & Security; проверьте уведомления и голос.
• Сохраните путь удаления: знайте, где лежат данные, чтобы не удалить единственную библиотеку памяти.

Runbook из 7 шагов: подготовка → официальная установка → вход → тест модели → одна низкорисковая интеграция → ожидание памяти → практика и отзыв. Только после этого — Slack, Notion и долгосрочные сценарии.