OpenHuman от TinyHumans AI — desktop-first персональный AI-агент: после подключения Gmail, календаря и GitHub контекст остаётся локально в Memory Tree и Obsidian-совместимом Markdown-vault на SQLite; опционально Ollama маршрутизирует инференс на устройстве. По запросу «OpenHuman установка» часто попадают на устаревшие Python-туториалы — в 2026 официальный путь это Homebrew / apt / подписанные установщики, а не pip install -r requirements.txt.
Гайд для новичков и разработчиков, которым нужна чистая установка на macOS, Windows или Linux без самостоятельной сборки Rust. Ниже — боли до установки, матрица хостов, нативные пакеты и шесть шагов: первый запуск, интеграции, Ollama, проверка Memory Tree и планирование хоста 24/7. После прочтения будет ясно, держать ли каталог данных на ноутбуке или на постоянно включённом Mac mini.
01 Боли до установки OpenHuman: это не «git clone + pip»
OpenHuman поставляется как десктопное приложение на Rust + Tauri + React (GPL-3.0, Early Beta). В отличие от OpenClaw (терминальный Gateway и экосистема Node) или Hermes Agent (установщик кладёт Python и Node в ~/.hermes/), конечному пользователю не нужно собирать Python-окружение; для вклада в исходники отдельно требуются Node 24+, pnpm и Rust.
- Устаревшие туториалы: статьи про «цифровых людей» с
conda createиcheckpoints/*.pthотносятся к другим шаблонам, не к репозиториюtinyhumansai/openhuman. - Скриптовая установка без подписи: README предупреждает, что
curl … | bashне обнаружит подмену скрипта; в продакшене предпочтительны Homebrew bottle / подписанный apt / MSI. - Локальное и управляемое: Memory Tree и рабочая область на диске, но вход по умолчанию, маршрутизация моделей и часть OAuth идут через бэкенд OpenHuman; полный офлайн — BYO-модели и прямой режим Composio по документации.
- Sleep рвёт синхронизацию: цикл auto-fetch около двадцати минут и фоновое сжатие памяти требуют бодрствующего хоста; сон ноутбука прерывает подтягивание контекста.
- Linux Wayland: AppImage на части Wayland-сессий падает при старте; пользователям Debian/Ubuntu лучше .deb / apt (issue #2463 в репозитории).
Установка часто укладывается в двадцать минут; долгосрочный опыт определяют uptime хоста 24/7 и возможность бэкапа vault и SQLite.
Команды и поведение сверяйте с официальной документацией TinyHumans после каждого релиза.
02 Требования OpenHuman и матрица хостов: где развёртывать
Официальные артефакты покрывают macOS (Intel / Apple Silicon), Windows 10/11, Linux (Debian/Ubuntu amd64, Arch AUR). Таблица ниже — для выбора хоста; RAM и диск подстраивайте под размер модели Ollama.
| Хост | Доступность 24/7 | Трение установки | Memory Tree / Ollama | Типичный минус |
|---|---|---|---|---|
| MacBook локально | Sleep при закрытии крышки | Низкое (Homebrew / .dmg) | Apple Silicon + Ollama комфортно | Обрыв auto-fetch, перезагрузки ОС |
| Windows ПК | Можно держать включённым | Низкое (подписанный MSI) | NVIDIA для локальных моделей | Нет macOS toolchain |
| Linux desktop / headless | Высокая на серверах | Среднее (apt лучше AppImage) | Ollama официально на Linux | Без GUI — проверьте дистрибутив |
| Mac mini M4 bare metal | SLA дата-центра | Низкое (SSH + brew) | UMA для моделей 7B–14B | Выбор региона и срока аренды |
Ресурсы с Ollama: только управляемые модели и лёгкие интеграции — от 8 ГБ RAM; постоянный Qwen2.5 / Gemma3 7B с browser-инструментами — 16 ГБ UMA и выше. Под Memory Tree, vault и SQLite заложите 10–30 ГБ SSD с запасом на рост почты и синхронизации репозиториев.
03 Официальные пути установки: Homebrew, apt и Release
Рекомендуемый порядок: скачать пакет с сайта или GitHub Releases → или системный менеджер пакетов с цепочкой подписи. Скрипт curl | bash — только если пакеты недоступны.
macOS (Homebrew, рекомендация upstream):
brew tap tinyhumansai/core
brew install openhuman
openhuman --version
Debian / Ubuntu (подписанный apt-репозиторий):
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
Windows: подписанный .msi с GitHub Releases.
Запасной путь (без проверки целостности, осторожно): скрипт из README; после релиза сверяйте статус GPG-верификации (issue #2620).
04 Шесть шагов: первый запуск, интеграции, Ollama и Memory Tree
- Установка и запуск: откройте OpenHuman из меню приложений; если CLI в PATH —
openhuman --versionи сверка с текущим tag на Releases. - Onboarding и аккаунт: пройдите мастер в UI; для управляемого режима нужен аккаунт OpenHuman (маршрутизация моделей и часть OAuth); локальные эксперименты — BYO / Ollama в настройках (документ Local AI).
- Ollama (опциональный локальный инференс): установите Ollama на macOS или Linux, выполните
ollama pullдля моделей из gitbook (Qwen2.5, Gemma3 и др.), выберите локальный endpoint в маршрутизации OpenHuman. - Дымовой тест интеграций: подключите GitHub или календарь с низкой чувствительностью, подождите цикл auto-fetch (~20 минут), проверьте появление новых Markdown-чанков в Memory Tree.
- Приёмка Memory Tree и vault: откройте Memory Tree / Obsidian-совместимый каталог, убедитесь, что SQLite и
.mdрастут; если пусто — OAuth и сеть, а не переустановка. - План хоста 24/7: для круглосуточного auto-fetch и каналов сообщений перенесите инстанс на Mac mini без sleep (локально или bare metal CALMVPS), заархивируйте рабочую область и конфиг перед сменой машины.
На bare metal Mac CALMVPS: выберите объём RAM M4 и регион на странице цен, зайдите по SSH, выполните те же brew install openhuman, перед сменой хоста упакуйте каталог данных OpenHuman (Memory Tree / vault).
05 Справочные параметры, типичные ошибки и когда выигрывает CALMVPS
- Стек: Rust + Tauri v2 + React; Memory Tree — локальный SQLite, чанки до ~3k token в Markdown (README / gitbook).
- Ритм синхронизации: активные интеграции тянут контекст примерно раз в 20 минут (не push в реальном времени).
- TokenJuice: вывод инструментов и веб-скрейп сжимаются перед LLM; upstream заявляет до ~80% экономии токенов — измеряйте на своих задачах.
| Симптом | Типичная причина | Действие |
|---|---|---|
| pip/conda-гайд падает | Чужая документация | Homebrew / apt / Release-установщик |
| AppImage на Linux падает | Wayland / sharun | .deb или env-обход из документации |
| Ollama не отвечает | Сервис или модель не подтянута | ollama serve + ollama pull <model> |
| Memory Tree пуст | OAuth или не прошёл цикл fetch | Проверить авторизацию, подождать ~20 минут |
FAQ: без дискретной GPU можно работать — управляемые модели не требуют GPU; локальный Ollama на Apple Silicon обычно плавнее, чем чистый CPU на Windows. На Mac M — arm64-пакет и arm64-модели Ollama. Медленная загрузка моделей — зеркало сети или предварительный ollama pull на Mac в дата-центре.
OpenHuman на ноутбуке с ежедневным sleep рвёт непрерывность auto-fetch и накопление Memory Tree. На дешёвом зарубежном VPS нет официального desktop-опыта и растёт стоимость GUI. Без бэкапа — потеря контекста при смене машины. Для подписанной установки, Ollama на Apple Silicon, двадцатиминутной синхронизации памяти и быстрого увеличения UMA помесячная аренда bare metal Mac mini M4 CALMVPS — типичный продакшен-дефолт: выделенный Apple Silicon, выдача по SSH, гибкие сроки. Тарифы — на странице цен CALMVPS; оформить заказ — аренда Mac mini M4.