Большинство гайдов по OpenHuman сводятся к «нажмите дальше» — и при первом сбое непонятно, виноваты загрузка, вход, модели или память. Здесь идём по нормальному сценарию настройки от начала до конца: на каждом этапе — признак успеха и что проверить, если застряли. Это не энциклопедия ошибок, а маршрут с нуля до рабочего первого запуска.
0 Обзор: семь этапов от нуля до первого результата
Если что-то пошло не так, сначала определите этап: загрузка → установка → вход → модели → интеграции → память → первый вывод. Таблица ниже — карта; дальше разберём каждый шаг подробнее.
| Этап | Признак успеха | Частая проблема | Дальше |
|---|---|---|---|
| Подготовка | Сайт открывается, RAM ≥ минимума | Сеть/DNS, мало RAM | Исправьте сеть или добавьте память до установки |
| Загрузка и установка | Приложение запускается; версия совпадает с сайтом | Не тот проект, не та архитектура | Проверьте домен и GitHub Release |
| Вход | Главный интерфейс виден | OAuth-редирект не срабатывает | Другой браузер; отключите блокировщики |
| Модели | На «Привет» есть ответ | BYOK или локальная модель молчит | Сначала облачная маршрутизация, потом локальная |
| Интеграции | Источник помечен как подключённый | OAuth истёк, узкие права | Повторная авторизация; проверьте scope синка |
| Память | В Memory есть записи | Пустое дерево, <20 мин ожидания | Дождитесь первого цикла auto-fetch |
| Первый запрос | Сводка/todo совпадают с данными | Нет контекста, неверные ответы | Разделите «модель vs память» |
1 Перед установкой: система, сеть, аккаунты, тестовые данные
По официальному Getting Started OpenHuman работает на macOS, Windows и Linux с рекомендуемыми 4 ГБ+ RAM. Для больших почтовых ящиков/репозиториев или локальных моделей на той же машине закладывайте 16 ГБ+.
- Сеть — открываются tinyhumans.ai/openhuman и документация GitBook. Стандартный путь всё ещё использует hosted-вход и маршрутизацию моделей (не полностью офлайн).
- Аккаунты — подготовьте Google/GitHub для входа. Сторонние коннекторы требуют отдельного OAuth; вход в приложение сам по себе Gmail не подключает.
- Тестовые данные — начните с мало чувствительного ящика или запасного GitHub, чтобы проверить запись в память. Не подключайте весь рабочий inbox в первый день.
- Локальные модели (опционально) — если планируете Ollama, сначала успешно выполните
ollama runв терминале, затем включайте Local AI в OpenHuman.
2 Источник загрузки: как заметить не тот проект или версию
Признак успеха: установщик с tinyhumans.ai/openhuman или официального канала; версия в About совпадает с последним GitHub Release.
Официальные пути (выберите один):
- Установщик с сайта — macOS DMG, Windows MSI/EXE, Linux AppImage или .deb (проще для новичков).
- Homebrew —
brew install tinyhumansai/openhuman/openhuman - Скрипт установки — macOS/Linux:
curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash; для Windows — PowerShell-скрипт из README. На основной машине предпочтительнее подписанная загрузка с сайта, чем pipe в shell.
tinyhumansai/openhuman, сторонний «all-in-one crack». При сомнении качайте только с официального сайта и org на GitHub.3 Установка по платформам: Mac, Windows, Linux
| Платформа | Критерий прохождения | Если застряли — проверьте |
|---|---|---|
| macOS | DMG установлен; приложение открывается; при запросе Gatekeeper → «Открыть» | Блокировка безопасностью → Системные настройки → Конфиденциальность и безопасность |
| Windows | MSI/EXE завершился; OpenHuman в меню «Пуск» | SmartScreen → проверьте издателя; отсутствует VC++ runtime |
| Linux | AppImage запускается или apt install прошёл | amd64 vs arm64 соответствует вашему CPU |
При первом запуске macOS может запросить Универсальный доступ или Мониторинг ввода (голосовые хоткеи). Проверьте Settings → Automation & Channels; права, не нужные для первого успешного запуска, можно отклонить.
4 Первый запуск: вход, рабочая область, не открывается
Экран приветствия — «Sign in! Let's Cook» с социальным входом. Большинству можно игнорировать Advanced custom core RPC URL.
Признак успеха: главный UI с чатом и Settings. Если застряли: OAuth блокируют расширения → Safari/Edge в приватном окне; вход прошёл, но пустой экран → полностью закройте и перезапустите; смотрите in-app логи/диагностику (точка входа зависит от версии в Settings).
5 Модели: маршрутизация по умолчанию, BYOK, молчание локальной модели
OpenHuman использует Automatic Model Routing под задачу. Новичкам: сначала убедитесь, что облачная маршрутизация отвечает, затем включайте Local AI.
Признак успеха: отправьте «Привет» или «Представься одним предложением» и получите нормальный ответ. Если застряли:
- Нет ответа вообще — сеть/прокси; сбой Early Beta (Discord/GitHub Issues).
- BYOK не работает — ключ вставлен целиком, провайдер совпадает с настройками, на аккаунте есть квота.
- Ollama / LM Studio молчит — сначала проверьте локальный сервис в терминале; затем Local AI в Settings и
local_ai.runtime_enabledпо GitBook Configuration.
6 Интеграции: OAuth, scope, обновление
Подключайте Gmail, GitHub, календари и т.д. в Settings. Признак успеха: в списке «подключено» без постоянных ошибок.
Если застряли: подключено, но нет данных → в scope есть права на fetch; для Google Workspace может понадобиться одобрение админа; нет обновления → подождите ~20 минут первого цикла auto-fetch (по докам) — не переустанавливайте через пару минут.
7 Синхронизация памяти: пустой контекст и проверка
Память хранится локально в Memory Tree (SQLite + Markdown). Откройте vault через Memory → View vault in Obsidian (/wiki/).
Признак успеха: в течение ~20 минут после подключения Gmail в Memory появляются записи; запрос «Что мне важно знать за последние 12 часов?» цитирует реальные темы писем.
Если застряли: всё ещё пусто → OAuth действительно прошёл, в тестовом аккаунте есть письма, первый цикл не завершён; плохая сводка → сверьте сырые записи в Obsidian, чтобы отделить галлюцинацию модели от отсутствия источника.
8 Первый боевой запрос: проверка настройки одним шагом
Попробуйте промпты из официальных примеров: «Summarize what I missed today.» или «From my connected sources, list my top three todos for today.»
Критерии прохождения: ① модель отвечает; ② факты в ответе есть в Memory/Obsidian; ③ узкий follow-up (например, имя проекта) тоже попадает. Падает только ② → путь памяти; только ① → модели; оба → вход и сеть.
9 Итог: когда переустанавливать, как сохранить конфиг
Сначала доки/Issues, потом переустановка: разовый сбой OAuth, одна интеграция или локальный Ollama обычно не требуют полной переустановки. Переустанавливайте при повреждённом пакете, чистом major-апгрейде или если так сказано в Release notes.
Чтобы сохранить данные: Memory Tree и Markdown-vault на диске — запишите путь vault на странице Memory и сделайте бэкап папки перед удалением (не удаляйте неизвестные директории). Удаление: brew uninstall openhuman для Homebrew; apt remove для Debian/Ubuntu; ручная установка через curl — см. GitHub docs/install.md.
Всё ещё застряли → GitHub Issues, Release notes или Discord (discord.tinyhumans.ai) с версией и шагами воспроизведения.
Проверьте все семь пунктов — и OpenHuman у вас работает и отлаживается:
- 1Установлено с официальных каналов; версия совпадает с Release
- 2Вход выполнен; главный UI и чат доступны
- 3Маршрутизация по умолчанию отвечает на «Привет»
- 4Хотя бы одна малочувствительная интеграция с OAuth
- 5В Memory есть записи; Obsidian открывает vault
- 6Первая сводка/todo совпадает с вашими данными
- 7Вы знаете, на каком этапе сбой и где официальная документация
10 Стабильнее запускать OpenHuman на Mac mini
OpenHuman в фоне делает auto-fetch, пишет в SQLite и опционально гоняет Ollama. У Mac mini M4 единая память удобна для небольших локальных моделей; потребление в простое около ~4 Вт подходит для тихой работы 24/7. На macOS установка через Homebrew, запросы прав и доступ к vault Obsidian проходят без лишней возни. Держать личный Memory Tree на отдельном mini — значит изолировать его от основного Mac. Если планируете первую лабораторию personal-agent, Mac mini M4 — понятная точка входа по цене; сначала отработайте сценарий здесь, затем перенесите на always-on узел Mac mini.
OpenHuman 24/7 · локальная памятьMac mini M4 для вашего узла OpenHuman
Низкое энергопотребление 24/7 · единая память для Ollama · изоляция от основного Mac при тестировании personal AI и памяти.