Если вы открываете репозиторий OpenHuman, то видите иной путь установки, чем у terminal-first шлюзов: onboarding через UI, локальный Memory Tree в SQLite, Obsidian-совместимый Markdown-vault и более сотни OAuth-интеграций, синхронизируемых каждые двадцать минут через auto-fetch. OpenHuman — не одноразовый чат. Это настольный агент под GPL-3.0 от TinyHumans AI (актуальная линия около v0.53.x), который хранит привычки неделями — но только если хост не засыпает и снимки диска не уничтожают конфиг. Это руководство сфокусировано на установке и настройке: tap Homebrew, подписанный apt-репозиторий, npm/pnpm из исходников или curl-скрипт, config.toml для локального ИИ, пути Memory Tree и приёмка на облачном Mac NUKCLOUD. Для комбинированного стека с OpenClaw и Ollama читайте полный гид OpenClaw + OpenHuman; для параллельного Telegram-шлюза следуйте руководству по установке Hermes Agent. Здесь — от нуля до Memory Tree, переживающего перезагрузку.
00Что вы устанавливаете и почему важен Memory Tree
OpenHuman от TinyHumans AI — agentic-ассистент для рабочего стола под лицензией GPL-3.0. Интерфейс Tauri, режим mascotte, нативный голосовой pipeline и Memory Tree отличают его от чисто CLI-шлюзов вроде Hermes или channel-first стеков вроде OpenClaw. Memory Tree канонизирует подключённые источники в Markdown-чанки до примерно трёх тысяч токенов, оценивает и сворачивает их в иерархические summary-деревья и хранит всё в SQLite на вашей машине. Те же чанки попадают как файлы .md в Obsidian-совместимый vault — local-first, зашифрованный, под вашим контролем.
Успешная установка — только первая преграда. Пользователи подключают Gmail, Notion или Slack и ожидают, что ассистент утром уже знает контекст календаря без повторных промптов. Это требует хоста, где циклы auto-fetch, файлы SQLite и каталоги vault переживают reboot и обновления ОС. MacBook разработчика подходит для шагов ниже; production на засыпающем ноутбуке — нет. Команды, наращивающие Memory Tree неделями, обычно переезжают на выделенный облачный Mac, когда пилот доказывает ценность.
OpenHuman по умолчанию использует managed-сервисы для входа, маршрутизации моделей и Composio OAuth. Можно работать со своими моделями, Ollama на loopback или прямым режимом Composio — это описано в upstream-документации. Выберите до установки cloud-API-first или local-AI-first, чтобы корректно выставить local_ai за одну сессию.
БОЛЬТребования к окружению и сбои до первого шага
Большинство тикетов OpenHuman — не сломанные инсталляторы. Это неверный хост, нехватка RAM для параллельных auto-fetch job или файлы Memory Tree на ephemeral-томах. Таблица сопоставляет ожидания по платформам с тем, что нужно OpenHuman для постоянно растущего Memory Tree.
| Платформа | Минимум | Рекомендуется | Типичный сбой до рабочего Memory Tree |
|---|---|---|---|
| macOS 14+ (Apple Silicon) | 4 ГБ RAM, 15 ГБ свободного диска | 16 ГБ RAM, 40 ГБ диска | GUI не стартует без VNC; Memory Tree на tmpfs пуст после reboot |
| Облачный Mac (production) | SKU 16 ГБ | 24 ГБ при параллельном Ollama 13B | Snapshot без backup конфига стирает SQLite; auto-fetch останавливается при sleep |
| Ubuntu 22.04 / Debian 12 | 4 ГБ RAM, amd64 | 16 ГБ RAM | Краш AppImage под Wayland; нет подписанного apt keyring |
| Только dev-ноутбук | Как минимум macOS | 16 ГБ | Ассистент умирает при sleep; двадцатиминутный sync рвётся ночью |
| Linux VPS без desktop | Не рекомендуется | — | Нет нативного Tauri GUI; Memory Tree сложно проверить без wizard |
- Планирование RAM: Лёгкий режим с cloud-маршрутизацией и малым числом интеграций работает на 4 ГБ RAM. Memory Tree с auto-fetch, сжатием TokenJuice и опциональным Ollama 7B/8B выигрывает от 16 ГБ RAM и выше. Параллельный 13B плюс desktop GUI на общем узле требует 24 ГБ или временного разделения с OpenClaw.
- Node для исходников: Контрибьюторам нужны Node.js 24+, pnpm 10.10.0, Rust 1.93.0 и desktop build prerequisites. Production-установки должны предпочитать нативные пакеты (brew/apt), а не npm-сборки на каждом reboot.
- Выделенный Unix-user: Запускайте OpenHuman под non-root с фиксированным home. Смешивать SQLite Memory Tree и vault с root или общими логинами усложняет backup и права OAuth-токенов.
- Разметка диска: Отдельное место для SQLite-памяти, Obsidian-vault и логов. Root-том 15 ГБ быстро заполняется, когда auto-fetch неделями тянет Gmail и Notion chunks.
- Заметка GPL-3.0: OpenHuman под GPL-3.0. Внутренние пилоты на арендованном узле обычны; при распространении или сетевом использовании бинарника проверяйте compliance — в отличие от MIT у Hermes или OpenClaw.
После установки убедитесь, что ассистент стартует и путь конфига лежит на persistent-диске, прежде чем подключать десять OAuth-интеграций. Исправление drift окружения заранее экономит часы восстановления SQLite.
01Установка: Homebrew, apt, npm и скрипт
Upstream рекомендует нативные пакетные пути с цепочкой подписи ОС. curl-скрипт — альтернатива, но без отдельной проверки целостности. На облачном Mac NUKCLOUD по SSH выполните эти шесть шагов по порядку.
-
01
Подготовить хост: На macOS подтвердите Xcode Command Line Tools. На Ubuntu
sudo apt-get install -y gnupg2 curl ca-certificates. Создайте выделенного пользователя вродеopenhumanс home на persistent-диске. -
02
Выбрать предпочтительный путь: macOS через Homebrew tap, Linux через подписанный apt-репозиторий, или для разработчиков npm/pnpm из clone. Production: brew или apt, не nightly npm.
-
03
Проверить бинарник: Запустить app на macOS или
openhuman --version, если CLI доступен. Учитывайте PATH и Gatekeeper для неподписанных артефактов. -
04
Первый GUI через VNC: На облачном Mac подключить VNC, пройти onboarding wizard, выбрать аккаунт или локальный режим.
-
05
Зафиксировать каталог config: Путь к
config.tomlи store Memory Tree из wizard или доки — база для backup. -
06
Baseline snapshot: Minor-версия macOS, tarball дерева config до старта OAuth и auto-fetch.
brew tap tinyhumansai/core
brew install openhuman
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
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
Выберите SKU и RAM до установки на странице цены, откройте инстанс через заказ. Для production 16 ГБ с Memory Tree плюс Ollama 8B хватит baseline SKU; параллельный 13B с OpenClaw требует upsizing до первого ollama pull.
02config.toml, локальный ИИ и Memory Tree
Локальный ИИ по умолчанию выключен. Явно включите его в config.toml (путь по wizard или доке), когда Ollama работает на том же хосте — типично на арендованном Mac Mini M4 с loopback-инференсом.
local_ai.runtime_enabled = true
local_ai.opt_in_confirmed = true
Endpoint Ollama: В настройках задайте http://127.0.0.1:11434, выберите tag модели под RAM — 7B/8B на 16 ГБ, более тяжёлые tags только с большим unified memory. OLLAMA_KEEP_ALIVE=-1 убирает cold-start latency при burst auto-fetch.
Memory Tree: Дерево растёт с каждой интеграцией и каждым двадцатиминутным циклом auto-fetch. SQLite и каталог vault должны лежать на одном persistent-томе. Опционально memory.backend = "agentmemory" для внешнего agentmemory store — полезно, если вы уже делите agentmemory с другими coding-агентами.
Smoke-test: Подключите одну интеграцию, дождитесь sync-цикла, затем в новой сессии спросите факт, который может прийти только из этой интеграции. Если recall падает после контролируемого reboot, исправьте persist диска и путь config до новых OAuth-flow.
После правки config.toml перезапустите ассистента и проверьте, что сжатие TokenJuice видно в логах — признак корректной компрессии tool output перед вызовом LLM.
03VNC-onboarding, персистентность и Ollama
OpenHuman — UI-first. Одного SSH недостаточно для первичной настройки на headless облачном Mac — нужны VNC или screen sharing для wizard, OAuth browser flow и теста mascotte.
VNC-flow: Откройте VNC из панели провайдера, запустите OpenHuman, подключите Gmail / Notion / Slack, задайте endpoint Ollama в настройках. Ограничьте VNC VPN или IP allowlist; OAuth-токены хранятся локально зашифрованными, но экран показывает чувствительное.
Сначала Ollama: До local_ai OpenHuman выполните brew install ollama, pull моделей, проверьте ollama serve через curl localhost:11434/api/tags. Порядок из гида OpenClaw + OpenHuman, если оба стека на одном узле.
Персистентность macOS: Зарегистрируйте OpenHuman как login item или LaunchAgent, чтобы auto-fetch продолжался после reboot. WorkingDirectory на home выделенного user. После reboot VNC-check: размер Memory Tree и timestamp последнего sync должны быть согласованы.
Ритм backup: Еженедельные tarballs каталога config, SQLite-памяти и vault на зашифрованный object storage. Во время пилота не делайте disk snapshot без backup — откат snapshot стирает недели Memory Tree без предупреждения.
ID инстанса и политику backup фиксируйте в консоли. Операционные вопросы — помощь; для параллельных Telegram-шлюзов следуйте руководству по установке Hermes на отдельном user или хосте, чтобы избежать RAM-конфликтов с Ollama.
04Матрица платформ: аренда облачного Mac vs альтернативы
| Измерение | Локальный MacBook | Linux VPS | Облачный Mac NUKCLOUD |
|---|---|---|---|
| Install (brew/apt/npm) | Все пути нативно | apt + AppImage; нет macOS GUI stack | brew нативно по SSH + VNC |
| Memory Tree 24/7 | Плохо при sleep | GUI gap; SQLite возможен, wizard нет | Отлично с launchd и питанием ЦОД |
| Рекомендуемая RAM | 16 ГБ для локального 8B | 16 ГБ; риски Wayland | SKU 16–24 ГБ на выбор |
| GPL-3.0 внутренне | Полный контроль | Возможно без desktop | Аудируемый tenant-диск |
| Типичная месячная стоимость | Sunk hardware | 5–40 USD плюс ops-время | По метрикам; см. цены |
OpenHuman требует macOS desktop и persistent SQLite — Linux VPS покрывают apt-install, но не заменяют Tauri-опыт. Домашние Mac Mini работают при дисциплине питания и VNC; enterprise-команды арендуют облачный Mac, когда Memory Tree должен расти месяцами без babysitting ноутбука.
Гибридные стеки распространены: Hermes или OpenClaw наружу, OpenHuman внутри для desktop-памяти. Раздельные Unix-аккаунты, модели Ollama по бюджету RAM, GPL и MIT лицензии раздельно в compliance-доках. После успешного пилота масштабируйте RAM через заказ, не перепроверяя OAuth, пока пути vault стабильны.