macOS Homebrew · Memory Tree · 118+ OAuth · таблица ошибок · VNC-чеклист удалённого Mac
OpenHuman от tinyhumansai — open-source десктопный персональный ИИ-агент: не очередное окно чата, а локальный слой интеллекта, объединяющий память, инструменты, интеграции и голос. Стабильный релиз v0.56.0 (2026-05-27) превысил 30 000 звёзд на GitHub. Это руководство охватывает рекомендуемый путь Homebrew на macOS, первичную настройку LLM, Memory Tree, 118+ OAuth-коннекторов, таблицу из 10 типичных ошибок и 20-минутный VNC-чеклист приёмки. Дополняет наш гид по развёртыванию OpenClaw и OpenHuman и туториал по установке Hermes Agent.
OpenHuman позиционируется как «Personal AI super intelligence» — приватный, простой и расширяемый. В отличие от OpenClaw или Hermes Agent (оба terminal-first, модель приносите сами), OpenHuman — GUI-first: десктопный маскот реагирует на контекст и продолжает работу в фоне, даже когда вы перестаёте печатать.
Стек: Rust + Tauri + React, лицензия GNU GPL-3.0. Проект всё ещё в Early Beta — читайте release notes перед обновлением. Сравнение с соседними инструментами:
| Параметр | OpenHuman | OpenClaw | Hermes Agent | Claude Cowork |
|---|---|---|---|---|
| Open source | GPL-3.0 | MIT | MIT | Проприетарный |
| Онбординг | Desktop GUI, минуты | Terminal-first | Terminal-first | Desktop + CLI |
| Память | Memory Tree + Obsidian | Зависит от плагинов | Трёхслойное обучение | На сессию |
| Интеграции | 118+ OAuth | BYO | BYO | Мало коннекторов |
| Автосинх | ~20 мин в память | Нет | Нет | Нет |
| Маршрутизация моделей | Встроенная + TokenJuice | Вручную | Вручную | Одна модель |
Если нужен ИИ, который реально видит ваш ежедневный workflow без жизни в терминале, коннекторы и Memory Tree OpenHuman — главное отличие. Поскольку приложение зависит от графического рабочего стола, чистый SSH ломается на первичных разрешениях и OAuth — здесь помогает VNC на арендованном Mac.
Локальное хранилище в ~/.openhuman/memory/ интересно командам с требованиями к данным: сводки коннекторов векторизуются локально. Вызовы API к выбранному LLM всё равно нужно учитывать в политике безопасности.
Для бинарной установки достаточно macOS 12 Monterey или новее (рекомендуется 14+). Для сборки из исходников планка выше:
| Зависимость | Бинарный пользователь | Разработческая сборка |
|---|---|---|
| macOS | 12+ (14+ рекомендуется) | То же |
| Node.js | Не нужен | 24+ |
| pnpm | Не нужен | 10.10.0 |
| Rust | Не нужен | 1.93.0 через rustup |
| CMake / Xcode CLT | Может запустить Homebrew | Обязательно |
| GPU / CUDA | Не нужны | Не нужны |
Вывод модели идёт через LLM-провайдера (API или локальный Ollama); приложение использует WebKit через Tauri, локальное GPU-обучение не требуется. 8 ГБ RAM хватит для лёгкого использования; с Memory Tree лучше 16 ГБ+, чтобы снизить swap. Диск: ~150–200 МБ на приложение; Memory Tree может вырасти до 2–5 ГБ; модели Ollama добавляются отдельно.
На Apple Silicon M1–M4 интерфейс плавный. На Intel первый native build дольше. OpenHuman + Ollama на арендованном Mac Mini M4: Memory Tree + модель 7B укладывается в 16 ГБ; более тяжёлые модели — 24 ГБ или только облачные API.
Официальные варианты: Homebrew tap (подписанная цепочка пакетов), .dmg с сайта, curl-скрипт (не рекомендуется), сборка из исходников. Семь шагов для Homebrew:
Установите Homebrew, если нет: brew --version. Установщик Homebrew может вызвать Xcode Command Line Tools — нажмите «Установить» в GUI. SSH не ответит на этот диалог.
Добавьте tap и установите:
brew tap tinyhumansai/core brew install openhuman
OpenHuman.app появится в ~/Applications. Первый tap тянет Formula с GitHub; brew install скачивает prebuilt и проверяет checksum.
Первый запуск и разрешения: Откройте через Spotlight. Выдайте Универсальный доступ и Уведомления в Конфиденциальность и безопасность — только в графической сессии.
Онбординг / LLM: Выберите Claude, OpenAI, Gemini, Grok или Ollama; введите API-ключи или TokenJuice. Для Memory Tree лучше модели с длинным контекстом.
OAuth-интеграции: Настройки → Integrations. Каждый коннектор открывает OAuth в браузере — нужен браузер по умолчанию на рабочем столе.
Включите Memory Tree: Настройки → Memory → Enable. Первая синхронизация 10–25 минут; не делайте force quit.
Smoke-тест: Спросите то, что знают только ваши коннекторы, например «О чём я писал в почте вчера?» при подключённом Gmail.
После установки обновления: brew upgrade openhuman. В Early Beta читайте release notes на GitHub перед апгрейдом в проде.
arm64 (Apple Silicon) или x86_64 с tinyhumans.ai/openhuman или GitHub Releases. Если Gatekeeper блокирует: Конфиденциальность и безопасность → Всё равно открыть.
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
Официальная документация предупреждает: нет независимой подписи скрипта. Сохраните в файл, проверьте, затем запускайте.
git clone https://github.com/tinyhumansai/openhuman.git cd openhuman git submodule update --init --recursive pnpm install pnpm --filter openhuman-app dev:app
Первый native build на M4 Pro часто 3–5 минут; на старых Intel дольше. Контрибьюторы тестируют патчи из исходников; конечным пользователям — Homebrew.
Memory Tree — ключевая функция OpenHuman: кросс-источниковый персональный граф знаний, который принимает сводки почты, PR, документов и календаря, обновляясь примерно каждые 20 минут.
В Настройки → Memory настройте интервал синх (минимум 5 минут) и область (например, Gmail только за 90 дней). Для Obsidian vault добавьте корень vault в Local Sources — изменения Markdown индексируются read-only, пока не включён Obsidian Write.
Исключайте чувствительные данные фильтрами коннекторов или каталогами вроде .private/. Локальная БД: ~/.openhuman/memory/ — бэкап перед миграцией. На арендованном Mac: экспорт или удаление перед возвратом узла по договору.
Практический совет из тикетов: первая синхронизация часто обрывается, если Mac засыпает. На удалённом Mac запустите caffeinate -dims на время sync или отключите сон до зелёной галочки.
| # | Симптом | Вероятная причина | Решение |
|---|---|---|---|
| 1 | brew tap 404 | Устаревший tap / сеть | brew update; использовать .dmg |
| 2 | WebKit process terminated | Старый macOS / битый кэш | macOS 12+; очистить ~/Library/WebKit/tinyhumansai |
| 3 | Мигает запрос Accessibility | TCC не зарегистрирован | Добавить OpenHuman вручную в Конфиденциальность |
| 4 | OAuth callback fails | Порты 58080–58090 заняты / неверный браузер | Освободить порты; Safari/Chrome по умолчанию |
| 5 | Memory Tree застрял на 0% | Токен истёк / сеть | Переавторизовать коннектор |
| 6 | Пустой ответ LLM | Неверный API-ключ / квота | Настройки → LLM → Test Connection |
| 7 | Auto-update fails | Не-Homebrew права | brew upgrade openhuman |
| 8 | Нет маскота | Масштаб экрана / Accessibility | Стандартный масштаб; перевыдать Accessibility |
| 9 | Obsidian watch idle | Пробелы в пути / Full Disk Access | Заключить путь в кавычки; выдать Full Disk Access |
| 10 | Нет микрофона / голоса | Разрешение микрофона | Конфиденциальность → Микрофон → OpenHuman |
Логи: ~/Library/Logs/tinyhumansai/. Ищите регрессии в GitHub Issues для вашей версии. В VNC-сессии убедитесь, что удалённый рабочий стол на переднем плане — некоторые TCC-диалоги видны только на физическом экране арендованного Mac при неверной настройке Screen Sharing.
Эти шаги требуют графической сессии и не работают только по SSH:
Подключитесь по VNC (1440×900+). Убедитесь, что рабочий стол виден.
Выполните brew tap tinyhumansai/core && brew install openhuman; подтвердите CLT при запросе.
Запустите OpenHuman из ~/Applications; одобрите все диалоги конфиденциальности.
Завершите настройку LLM и минимум одну OAuth-интеграцию в удалённом браузере.
Дождитесь первой синхронизации Memory Tree (зелёная галочка); задайте вопрос по коннектору для проверки recall.
После приёмки OpenHuman может работать 24/7 на удалённом Mac, а вы подключаетесь по VNC с Windows или Linux только по необходимости. Подходит командам без локального Apple-железа, которым нужен постоянный графический сеанс.
Да. UI на WebKit; вывод через API или Ollama. ANE Apple Silicon помогает локальному Ollama, но необязателен.
Первичная векторизация истории авторизованных коннекторов в локальный граф — обычно 10–25 минут. Держите сеть стабильной, не делайте force quit.
Homebrew: brew upgrade openhuman. Установки .dmg: обновление в приложении или последний release. В Early Beta следите за release notes.
OpenHuman снижает порог входа в персональный ИИ-слой с GUI-онбордингом, Memory Tree и глубокими интеграциями — но ценность привязана к постоянному доступу к рабочему столу для разрешений и OAuth. Если основная машина — Windows или Linux, или нужен headless Mac 24/7, покупка железа добавляет амортизацию и риски питания; арендованный Mac с VNC позволяет один раз пройти GUI-настройку и держать агента онлайн без локальной инфраструктуры.
Удалённые Mac-узлы VNCMac включают графический рабочий стол именно для этого пути приёмки — нажмите кнопку ниже, выберите тариф и следуйте нашему гиду подключения, чтобы зайти по VNC и выполнить чеклист из раздела 07.