Руководство по установке OpenHuman (2026): цифровой двойник ИИ за 5 минут

Если вы уже видели OpenHuman на GitHub, но ещё не установили — это самый короткий путь к рабочей системе в 2026 году: от загрузки до момента, когда агент скажет «у вас сегодня днём встреча». Шаг за шагом, около 5 минут для опытного пользователя (с учётом OAuth и первой синхронизации). OpenHuman — не очередной чат в браузере, а desktop-агент и персональный цифровой двойник ИИ: локальный Memory Tree, 118+ OAuth-интеграций, фоновая синхронизация примерно каждые 20 минут. После установки читайте наши материалы об архитектуре и Memory Tree и об Agent Skills; здесь только как установить, настроить и проверить успех.

Сила OpenHuman — в связке: данные остаются на вашем компьютере, но агент может читать Gmail, календарь и GitHub — если первичная настройка выполнена правильно. Запуск без OAuth и модели даёт пустой интерфейс и типичное разочарование. Это руководство этого избегает: каждый шаг заканчивается понятной проверкой, чтобы не гадать, сработала ли установка.

Что подготовить перед установкой

OpenHuman — desktop-приложение на Tauri (ядро Rust + web UI), официально поддерживаются macOS, Windows и Linux. В 2026 году лучший опыт по-прежнему на Mac с Apple Silicon — особенно если Ollama или MLX работают на той же машине. Перед стартом проверьте:

• Системные разрешения — на macOS разрешите загруженное приложение в «Конфиденциальность и безопасность» (или правый клик → Открыть вне App Store).
• Хотя бы один доступ к LLM — API-ключ Anthropic / OpenAI или локальный Ollama (опционально). Без ключа интерфейс откроется, но агент не сможет рассуждать.
• 2–3 аккаунта для подключения — для первого прохода: Gmail + Google Calendar + GitHub (разработчики) или Notion + Slack (знаниевая работа). Без источников Memory Tree пуст, и проверка за 5 минут провалится.
• Диск и сеть — Memory Tree пишет в локальный SQLite и Markdown; заложите сотни мегабайт. OAuth и первый fetch требуют стабильного интернета.

Полные зависимости и сборка из исходников — в docs/ официального репозитория; для повседневного использования clone не нужен. Сначала выполните самопроверку окружения в терминале:

# 1. Система и чип (Apple Silicon = arm64)
sw_vers
uname -m

# 2. Homebrew доступен? (для установки через brew)
brew --version
brew doctor

# 3. Для локального Ollama: порт 11434 свободен?
lsof -i :11434 || echo "Порт 11434 свободен, Ollama можно запускать"

# 4. Место на диске (Memory Tree + кэш моделей, ≥5 ГБ)
df -h ~

Если uname -m выводит arm64, скачивайте бинарник Apple Silicon. На Intel Mac явно проверьте x64-вариант в GitHub Releases — не все дистрибутивы одновременно публикуют обе архитектуры.

Три способа: официальный пакет, Homebrew, скрипт

Официальный README рекомендует: подписанные нативные установщики или системный менеджер пакетов. Скрипт — для быстрого теста, но выше риск supply chain. Таблица по приоритету.

# Открыть последний Release (arm64 / x64 под чип)
open "https://github.com/tinyhumansai/openhuman/releases/latest"
# или страницу загрузки
open "https://tinyhumans.ai/openhuman"

# После загрузки: смонтировать DMG и скопировать в Программы
hdiutil attach ~/Downloads/OpenHuman*.dmg
cp -R "/Volumes/OpenHuman/OpenHuman.app" /Applications/
hdiutil detach "/Volumes/OpenHuman"

# Если «разработчик не может быть проверен» — снять карантин
xattr -dr com.apple.quarantine /Applications/OpenHuman.app
open -a OpenHuman

# 1. Добавить официальный tap (один раз)
brew tap tinyhumansai/core

# 2. Установить (тянет текущий stable binary)
brew install openhuman

# 3. Проверить PATH
which openhuman
openhuman --version

# 4. Запустить desktop (CLI или Launchpad)
openhuman

# 5. Обновление позже
brew update
brew upgrade openhuman

# Альтернатива без core tap (в некоторых docs)
# brew install tinyhumansai/openhuman/openhuman

# Проверить версию Node
node -v

# Установить npm-пакет (native binary + SHA-256)
npm install -g openhuman

openhuman --version
openhuman

# 1. Импорт GPG и добавление apt-источника
sudo apt-get install -y 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

# 2. Установить и запустить
sudo apt-get update
sudo apt-get install -y openhuman
openhuman --version

# 1. Скачать скрипт без выполнения
curl -fsSL \
  https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh \
  -o /tmp/openhuman-install.sh
less /tmp/openhuman-install.sh

# 2. dry-run для превью (если поддерживается)
bash /tmp/openhuman-install.sh --dry-run --verbose

# 3. Установить после проверки
bash /tmp/openhuman-install.sh

# One-liner macOS / Linux (эквивалент шага 3)
curl -fsSL \
  https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh \
  | bash

# Windows PowerShell:
irm https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.ps1 | iex

macOS по шагам: от установки до проверки

Ниже — копируемый маршрут terminal + GUI: по умолчанию Homebrew + Anthropic API; при DMG начинайте с шага 3. После каждого шага — как подтвердить успех.

brew tap tinyhumansai/core
brew install openhuman
openhuman --version
open -a OpenHuman

# Приложение запущено? (должен быть процесс OpenHuman)
pgrep -lf -i openhuman || ps aux | grep -i openhuman | grep -v grep

# Установить и запустить Ollama в фоне
brew install ollama
brew services start ollama

# Небольшая модель для проверки связи
ollama pull llama3.2

# Проверка API: JSON со списком models
curl -s http://127.0.0.1:11434/api/tags | head -c 400
echo

# GUI: Settings → Models / Providers
#   - Cloud: ключ Anthropic (sk-ant-...) или OpenAI
#   - Local: Base URL http://127.0.0.1:11434, модель напр. llama3.2

# Не писать ключ в history shell; временный export:
read -s ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY
# (ввод без echo; затем unset ANTHROPIC_API_KEY)

# Проверить ключ Anthropic независимо от OpenHuman
curl -s https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}' \
  | head -c 300
echo

# GUI: Connections / Integrations → Connect
#   Рекомендуемый порядок: Gmail → Google Calendar → GitHub
# После OAuth в браузере: Connected / Active в приложении

# При проблемах с proxy — проверить HTTPS:
curl -sI https://github.com | head -5
curl -sI https://accounts.google.com | head -5

# Держать OpenHuman 5–20 мин; статус sync в строке меню
# Путь в Settings → Data / Memory
# Часто под Application Support; грубый поиск:
find ~/Library/Application\ Support -maxdepth 3 -iname '*openhuman*' 2>/dev/null

# Известный корень $MEMORY_DIR — последние Markdown:
# MEMORY_DIR="…/memory"   # путь из настроек
# ls -lt "$MEMORY_DIR" | head
# find "$MEMORY_DIR" -name '*.md' -mtime -1 | head

# Выборочно: реальные темы (почта/встреча/PR)?
# head -40 "$(find "$MEMORY_DIR" -name '*.md' | head -1)"

# Тест 1 — календарь (Google Calendar подключён)
«Перечисли мои встречи на сегодня с названием и временем начала, со ссылкой на источник в Memory Tree.»

# Тест 2 — GitHub (GitHub подключён)
«В каком репозитории у меня недавно были merged PR? Название repo и заголовок PR.»

# Общие ответы: вернуться к шагу 6 — созданы ли .md?

Чек-лист первой настройки за 5 минут

Если удобнее галочки: список один к одному соответствует предыдущему разделу. Отсчёт — когда приложение уже открыто.

1. Минута 1: провайдер модели — Ключ Anthropic / OpenAI в Settings или Base URL Ollama http://127.0.0.1:11434; проверка через curl …/api/tags или зонд Anthropic.
2. Минуты 2–3: OAuth — Подключить Gmail, Calendar, GitHub; после auth в браузере статус Connected.
3. Минута 4: первая sync — App работает; find ~/Library/Application Support -iname '*openhuman*' для каталога и сегодняшних .md.
4. Минута 5: тест диалога — Тесты 1 и 2; конкретные факты = успех.

На практике OAuth часто занимает больше минуты — это пять минут активной работы плюс фоновое ожидание. В первый день лучше заложить полчаса, чтобы Memory Tree успел наполниться.

Подключение сервисов и проверка Memory Tree

Ощущение «цифрового двойника» даёт Memory Tree: данные третьих сторон нормализуются в Markdown-блоки ≤3k token, SQLite локально, экспорт .md для Obsidian. Не доверяйте только зелёным индикаторам — проверяйте, что файлы реально на диске:

• В приложении Memory Tree / каталог памяти: новые файлы с сегодняшней датой.
• Открыть .md в редакторе: тема письма, название встречи, PR — проверяемые факты, не пустые шаблоны.
• Опционально: общий backend с agentmemory, чтобы OpenHuman и Claude Code делили память (продвинутый уровень).

# Количество Markdown, созданных сегодня
find "$MEMORY_DIR" -name '*.md' -mtime -1 2>/dev/null | wc -l

# 3 последних фрагмента по времени изменения
find "$MEMORY_DIR" -name '*.md' -print0 2>/dev/null \
  | xargs -0 ls -lt 2>/dev/null | head -3

# SQLite рядом (имя зависит от версии)
find "$MEMORY_DIR/.." -maxdepth 2 -name '*.sqlite' -o -name '*.db' 2>/dev/null
# DB="/path/to/openhuman.db"
# sqlite3 "$DB" ".tables"

Отличие от ChatGPT: там контекст в диалоге; у OpenHuman он в аудируемых файлах на вашем диске — одна из причин хайпа на GitHub. Продуктовый контекст — в нашем отчёте за пять дней.

Mac продвинутый: локально vs облачный Mac 24/7

OpenHuman рассчитан на постоянную работу на desktop: закрытие крышки замедляет sync. Если двойник должен тянуть сводки почты вечером, пока ноутбук выключен, подойдёт всегда online Mac mini — например облачный Mac ZavCloud на выделенном узле: настоящий macOS, статический IP, стабильные OAuth-callback. OAuth-токены и файлы Memory Tree — чувствительные данные: шифрование, контроль доступа и бэкапы отдельно; не кладите личный Gmail в shared multi-tenant без продуманной политики.

На локальном Apple Silicon Ollama / MLX дают офлайн-инференцию — в духе local-first: модели и память локально, только sync интеграций через интернет. Для iOS-разработки Cursor / Claude Code остаются coding-инструментами; перед спринтом OpenHuman ответит «насколько загружен календарь сегодня?» — похожие гибридные workflow в Anthropic и Claude Code.

# После входа на macOS cloud-хост
brew tap tinyhumansai/core && brew install openhuman
openhuman --version

# Без GUI: некоторые версии только sync engine — см. официальные docs
# Рекомендация: первый OAuth через VNC/screen sharing, сессия остаётся залогиненной

# Избежать сна (по политике дата-центра)
sudo pmset -c sleep 0 displaysleep 0

Устранение неполадок

• Не открывается (macOS) — Настройки → Конфиденциальность → всё равно открыть; или правый клик → Открыть. MDM может блокировать неподписанные пакеты — подписанный DMG из Releases.
• OAuth callback failed — Proxy/VPN, системное время, блокировка popup; корпоративные сети иногда блокируют Composio — whitelist IT.
• Memory Tree пуст — Интеграции Connected; дождаться полного цикла (~20 мин); Issues на региональные API limits.
• Агент выдумывает — Память не записана или модель не использует memory tools; сузить тест, @ на memory file если поддерживается.
• brew install не находит — Сначала brew tap tinyhumansai/core; на Intel Mac проверить архитектуру в Releases.

# Ошибка Homebrew: очистить кэш и переустановить
brew update
brew cleanup
brew reinstall openhuman

# Crash log после падения
log show --predicate 'process == "OpenHuman"' --last 1h | tail -50

# Ollama работает, OpenHuman не подключается
curl -s http://127.0.0.1:11434/api/tags
lsof -i :11434

# Полное удаление и reinstall (brew)
brew uninstall openhuman
rm -rf ~/Library/Application\ Support/*openhuman* 2>/dev/null
brew install openhuman

# Последние Issues (gh CLI)
gh issue list -R tinyhumansai/openhuman -L 5

git clone https://github.com/tinyhumansai/openhuman.git
cd openhuman
git submodule update --init --recursive
pnpm install
# Только web UI
pnpm dev
# Полная Tauri desktop разработка
pnpm dev:app
# Проверка Rust-стороны
cargo check -p openhuman --lib

FAQ

Нужен ли интернет? Установка, OAuth и облачные модели — да; файлы памяти локально. С локальным Ollama — диалог при слабой сети; sync почты/календаря всё равно online.

Это бесплатно? Клиент open source (GPL-3.0); API моделей и некоторые коннекторы могут стоить денег — по счёту провайдера.

Конфликт с Cursor Rules / Claude Code? Нет. OpenHuman не редактирует repo; coding-агенты не читают Gmail. Разные слои.

• Продукт — Что такое цифровой двойник OpenHuman
• Skills — Agent Skills и тренд GitHub
• Сравнение — OpenHuman vs OpenClaw