2026 OpenHuman: руководство по установке — Memory Tree, brew/apt/npm и аренда облачного Mac

TinyHumans AI поставляет OpenHuman под GPL-3.0 как настольного супер-ассистента с Memory Tree, интерфейсом Tauri и опциональным локальным ИИ. Этот runbook ведёт от чистого shell до production-ready ассистента на арендованном облачном Mac — пути Homebrew, apt и npm, config.toml и персистентность SQLite-памяти.

Если вы открываете репозиторий 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 13BSnapshot без backup конфига стирает SQLite; auto-fetch останавливается при sleep
Ubuntu 22.04 / Debian 124 ГБ RAM, amd6416 ГБ RAMКраш AppImage под Wayland; нет подписанного apt keyring
Только dev-ноутбукКак минимум macOS16 ГБАссистент умирает при 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 выполните эти шесть шагов по порядку.

  1. 01
    Подготовить хост: На macOS подтвердите Xcode Command Line Tools. На Ubuntu sudo apt-get install -y gnupg2 curl ca-certificates. Создайте выделенного пользователя вроде openhuman с home на persistent-диске.
  2. 02
    Выбрать предпочтительный путь: macOS через Homebrew tap, Linux через подписанный apt-репозиторий, или для разработчиков npm/pnpm из clone. Production: brew или apt, не nightly npm.
  3. 03
    Проверить бинарник: Запустить app на macOS или openhuman --version, если CLI доступен. Учитывайте PATH и Gatekeeper для неподписанных артефактов.
  4. 04
    Первый GUI через VNC: На облачном Mac подключить VNC, пройти onboarding wizard, выбрать аккаунт или локальный режим.
  5. 05
    Зафиксировать каталог config: Путь к config.toml и store Memory Tree из wizard или доки — база для backup.
  6. 06
    Baseline snapshot: Minor-версия macOS, tarball дерева config до старта OAuth и auto-fetch.
macOS — Homebrew (рекомендуется)
brew tap tinyhumansai/core
brew install openhuman
Linux — подписанный apt-репозиторий (Debian/Ubuntu amd64)
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-скрипт (macOS/Linux x64)
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash
Разработчик — npm/pnpm из исходников
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-инференсом.

config.toml — включить локальный ИИ
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.

Цифры для планирования: Auto-fetch идёт примерно каждые 20 минут на активную интеграцию. Chunks ограничены примерно 3 000 токенов. Лёгкий режим от 4 ГБ RAM; production Memory Tree с локальной 8B-моделью — 16 ГБ RAM. OpenHuman под GPL-3.0; Hermes и OpenClaw остаются MIT — учитывайте mix лицензий.

После правки 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 альтернативы

ИзмерениеЛокальный MacBookLinux VPSОблачный Mac NUKCLOUD
Install (brew/apt/npm)Все пути нативноapt + AppImage; нет macOS GUI stackbrew нативно по SSH + VNC
Memory Tree 24/7Плохо при sleepGUI gap; SQLite возможен, wizard нетОтлично с launchd и питанием ЦОД
Рекомендуемая RAM16 ГБ для локального 8B16 ГБ; риски WaylandSKU 16–24 ГБ на выбор
GPL-3.0 внутреннеПолный контрольВозможно без desktopАудируемый tenant-диск
Типичная месячная стоимостьSunk hardware5–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 стабильны.

05Частые вопросы

Homebrew, apt или npm — какой путь для production?
Upstream рекомендует brew tap tinyhumansai/core на macOS и подписанный apt-репозиторий на Debian/Ubuntu. curl-скрипт и npm/pnpm-сборки подходят разработчикам и быстрым пилотам, не long-term Memory Tree без pin release.
Хватит ли 4 ГБ RAM или нужно 16 ГБ?
4 ГБ достаточно для cloud-маршрутизации и малого числа интеграций без локального Ollama. 16 ГБ рекомендуем для Memory Tree с auto-fetch, desktop GUI и Ollama 7B/8B на том же облачном Mac. Параллельный 13B плюс OpenClaw → 24 ГБ или временное разделение.
Где живёт Memory Tree и как его бэкапить?
SQLite и Obsidian-vault лежат локально под деревом config OpenHuman на вашей машине. Еженедельные tarballs config, SQLite и vault; snapshot провайдера только после export. Auto-fetch не останавливается автоматически при полном диске — следите за местом.
OpenHuman, OpenClaw или Hermes?
OpenHuman: desktop, Memory Tree, GPL-3.0. OpenClaw: больше messaging-каналов, MIT (комбинированный гид). Hermes: Telegram gateway, SQLite-эпизоды, MIT (руководство по установке). Параллельно на разных home — возможно; следите за RAM и портами.
Когда арендовать NUKCLOUD вместо self-hosting?
Арендуйте, если нужны минимум два критерия: Memory Tree 24/7 без sleep ноутбука, пилотный месяц до CapEx Mac Mini или командный VNC-доступ к одному vault. Начните с цены и заказ; консоль — консоль; поддержка — помощь.