GitHub で OpenHuman を目にしたものの、まだ手を付けていないなら、これが2026 年最短の実装ルートです。ダウンロードから Agent が「今日の午後、会議がありますよ」と言えるまで——手順どおり進めれば、OAuth ダイアログと初回同期の待ち時間を含め慣れたユーザーなら約 5 分。OpenHuman はまた一つのチャット Web ページではなく、デスクトップ級の個人 AI デジタルツインです。ローカル Memory Tree、118+ サービスの OAuth、約 20 分周期のバックグラウンド同期。インストール後はアーキテクチャと Memory Tree、Agent Skill の深掘り記事もどうぞ。本記事は「どう入れるか、どう設定するか、成功をどう確認するか」だけに絞ります。
インストール前の準備
OpenHuman は Tauri デスクトップアプリ(Rust コア + Web UI)で、公式には macOS、Windows、Linux をサポートしています。2026 年時点では Apple Silicon Mac が最も快適——ローカル Ollama や MLX 推論と同一マシンに載せるとレイテンシが低くなります。インストール前に以下を確認してください:
- システム権限— macOS では「プライバシーとセキュリティ」でダウンロードした App を許可(App Store 外の場合は右クリック→「開く」)。
- LLM 認証情報を 1 つ以上— Anthropic / OpenAI API Key、または稼働中の Ollama(任意)。Key がなくても UI は開けますが、Agent は推論できません。
- 接続するアカウントを 2〜3 個— 初回は Gmail + Google Calendar + GitHub(開発者)または Notion + Slack(ナレッジワーカー)を推奨。空の Memory Tree では 5 分検証は失敗します。
- ディスクとネットワーク— Memory Tree はローカル SQLite + Markdown に書き込み、数百 MB を確保。OAuth と初回取得には安定した回線が必要。
依存関係とソースビルドは公式リポジトリの docs/ を参照。日常利用ではクローン不要です。半ばでアーキテクチャや Homebrew 未整備に気づかないよう、ターミナルで環境セルフチェックを先に実行することをおすすめします:
# 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 + モデルキャッシュ、≥5GB 推奨) df -h ~
3 つのインストール方法:公式パッケージ、Homebrew、スクリプト
公式 README では、署名付きネイティブインストーラーまたはシステムパッケージマネージャーを優先し、スクリプトはクイック体験向けだがサプライチェーンリスクが高いと明記されています。下表は推奨順です。
| 方法 | 向いている人 | コマンド / 入口 |
|---|---|---|
| 公式インストーラー(推奨) | macOS / Win / Linux | tinyhumans.ai/openhuman または GitHub Releases(DMG / MSI / deb / AppImage) |
| Homebrew(macOS / Linux) | ターミナルに慣れた Mac ユーザー | brew tap tinyhumansai/core → brew install openhuman |
| ワンラインスクリプト(デモ用) | お試し、CI サンドボックス | curl -fsSL …/install.sh | bash(先に --dry-run 可) |
# ブラウザで最新 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" # macOS が「開発元を確認できない」とブロックした場合、隔離属性を解除してから開く xattr -dr com.apple.quarantine /Applications/OpenHuman.app open -a OpenHuman
# 1. 公式 tap を追加(初回のみ) brew tap tinyhumansai/core # 2. インストール(現在の stable バイナリを取得) brew install openhuman # 3. PATH に入ったか確認 which openhuman openhuman --version # 4. デスクトップ版を起動(CLI が App を起動、または Launchpad から OpenHuman) openhuman # 5. 今後のアップグレード brew update brew upgrade openhuman # 代替:core tap を追加しない場合の一部ドキュメント記載 # brew install tinyhumansai/openhuman/openhuman
# Node バージョン確認 node -v # npm パッケージをインストール(初回はプラットフォーム別ネイティブバイナリを SHA-256 検証付きで取得) npm install -g openhuman openhuman --version openhuman
# 1. GPG をインポートして apt ソースを追加(公式 install ドキュメント手順) 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 # 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
セキュリティ注意
パイプスクリプト(curl | bash)はどのプロジェクトでもサプライチェーンリスクがあります。企業環境では 署名 DMG + MDM 配布、または内部ミラー Homebrew tap を利用してください。個人学習ではスクリプトも可ですが、本番キーがあるマシンでは裸実行しないでください。
macOS 手順コマンド:インストールから検証まで(完全例)
以下はコピー可能なターミナル + GUI ハイブリッド経路です。デフォルトは Homebrew インストールと Anthropic API。DMG 経由なら「ステップ 3」から開始。各ステップ後に成功確認方法を記載しています。
brew tap tinyhumansai/core brew install openhuman openhuman --version open -a OpenHuman # App が起動しているか確認(OpenHuman 関連プロセスが見えるはず) pgrep -lf -i openhuman || ps aux | grep -i openhuman | grep -v grep
# Ollama をインストールしてバックグラウンド起動(OpenHuman とは別だが同一 GPU 共有可能) 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 # - クラウド:Anthropic API Key(sk-ant-...)または OpenAI Key を貼り付け # - ローカル:Base URL に http://127.0.0.1:11434、モデルに llama3.2 など # Key を shell 履歴に書かない;CLI テストで環境変数が必要なら一時 export: read -s ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY # (入力後 Enter、ターミナルはエコーなし;終了後 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 完了後、App に Connected / Active と表示されるはず # 会社プロキシでコールバック失敗時、HTTPS 出站を先にテスト: curl -sI https://github.com | head -5 curl -sI https://accounts.google.com | head -5
# OpenHuman を 5〜20 分起動したまま;メニューバーで同期状態を確認可 # データディレクトリはバージョンにより異なる:App「Settings → Data / Memory」でパスを確認 # 多くは Application Support 配下、find で粗く検索(数秒かかる場合あり): find ~/Library/Application\ Support -maxdepth 3 -iname '*openhuman*' 2>/dev/null # Memory Tree ルートが $MEMORY_DIR と分かっている場合、最新 Markdown を一覧: # MEMORY_DIR="…/memory" # 設定画面のパスに置換 # ls -lt "$MEMORY_DIR" | head # find "$MEMORY_DIR" -name '*.md' -mtime -1 | head # 任意 .md に実データ行(メール/会議/PR)があるか spot チェック # head -40 "$(find "$MEMORY_DIR" -name '*.md' | head -1)"
# テスト 1 — カレンダー(Google Calendar 接続済みが前提) 「今日の会議タイトルと開始時刻を一覧し、Memory Tree の出典を引用してください。」 # テスト 2 — GitHub(GitHub 接続済みが前提) 「最近マージした PR があるリポジトリは?リポジトリ名と PR タイトルを教えて。」 # 失敗時:回答が泛泛としていればステップ 6 に戻り .md が生成されたか確認
5 分初回設定チェックリスト(順番にチェック)
長いコマンドよりチェックリスト派なら、以下を順に。前節のコマンドと1 対 1 対応。計測はアプリ起動後から。
- 1 分目:モデルプロバイダー選択— Settings に Anthropic / OpenAI Key、または Ollama Base URL
http://127.0.0.1:11434。curl …/api/tagsまたは Anthropic プローブでキー有効性を確認。 - 2〜3 分目:OAuth 接続— Connections で Gmail、Calendar、GitHub を Connect。ブラウザ認可後 Connected 表示。
- 4 分目:初回同期トリガー— App を起動したまま。
find ~/Library/Application Support -iname '*openhuman*'でデータディレクトリを特定し、当日の.mdを確認。 - 5 分目:会話検証— 前節「テスト 1 / 2」で質問。具体的事実を引用できれば成功。
サービス接続と Memory Tree 検証
OpenHuman の「デジタルツイン感」はMemory Tree から来ます。サードパーティデータが ≤3k token の Markdown ブロックに正規化され、ローカル SQLite に書き込まれ、Obsidian で開ける .md としてエクスポートされます。動作確認は UI の緑ランプだけでなく、ファイルがディスクに落ちたかを見てください:
- アプリ内 Memory Tree / メモリディレクトリで、新規ファイルのタイムスタンプが今日であることを確認。
- テキストエディタで任意の
.mdを開き、メール件名、会議タイトル、PR 名など照合可能な事実があり、空テンプレートでないこと。 - 任意: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 がある場合(ファイル名はバージョン依存)、sqlite3 でテーブル確認 find "$MEMORY_DIR/.." -maxdepth 2 -name '*.sqlite' -o -name '*.db' 2>/dev/null # DB="/path/to/openhuman.db" # sqlite3 "$DB" ".tables"
「ChatGPT との違いは?」—— ChatGPT のコンテキストは会話内、OpenHuman のコンテキストはディスク上で監査可能なファイル。だから GitHub で話題になっています。製品背景は5 日間体験記も参照。
OpenClaw との役割分担は?
OpenHuman は個人コンテキスト(メール、カレンダー、ノート)。OpenClaw は IM オーケストレーションとビルドパイプライン向け。OpenHuman を入れても Xcode CI は代替しません。OpenClaw を入れても受信トレイは自動では読めません。両方併用が現実的です。
Mac ユーザー向け:ローカル vs クラウド Mac 常駐
OpenHuman はデスクトップ常駐向け設計:蓋を閉じてスリープすると同期が遅れます。「退勤後 PC を切ってもツインがメール要約を取り続ける」なら、常時オンラインの Mac mini に載せる——例えば ZavCloud クラウド Mac 専有ノード:ネイティブ macOS、固定 IP、OAuth コールバックと長期バックグラウンドタスクに適しています。注意:OAuth トークンと Memory Tree ファイルは機密。クラウド展開ではディスク暗号化、アクセス制御、バックアップを別途。個人 Gmail をマルチテナント共有環境に直接置かないでください。
ローカル Apple Silicon では Ollama / MLX でオフライン推論も可能——OpenHuman の「データはローカル」という物語と一致。モデルもメモリもローカル、連携同期だけが外網。iOS 開発ならコーディングは Cursor / Claude Code、着手前に OpenHuman に「今日会議多い?」と聞く——Anthropic と Claude Code の記事で似たハイブリッドワークフローを書きました。
# macOS クラウドホストにログイン後 brew tap tinyhumansai/core && brew install openhuman openhuman --version # GUI なし環境では一部バージョンが同期エンジンのみ実行可能;公式ドキュメント参照 # 推奨:VNC/画面共有で初回 OAuth を完了し、セッションをログイン維持 # 蓋閉じスリープで同期が止まらないよう(データセンター方針に応じて) sudo pmset -c sleep 0 displaysleep 0
トラブルシューティング
- インストール後に開けない(macOS)— システム設定 → プライバシーとセキュリティ → それでも開く;または App を右クリック → 開く。企業 MDM が未公証パッケージをブロックする場合は Releases の署名 DMG を利用。
- OAuth コールバック失敗— プロキシ/VPN、システム時刻、ブラウザのポップアップブロックを確認。社内ネットが Composio ドメインを遮断している場合は IT にホワイトリスト依頼。
- Memory Tree が空のまま— 連携が Connected か確認。完全な同期周期(約 20 分)を待つ。公式 Issues で地域 API レート制限がないか確認。
- Agent が hallucinate— メモリ未書き込み、またはモデルが「メモリ読取」ツール未有効。質問範囲を絞り、@ で特定メモリファイルをテスト(バージョン対応時)。
- brew install が見つからない— 先に
brew tap tinyhumansai/coreしてから install。Intel Mac は Releases に該当アーキテクチャがあるか確認。
# Homebrew インストール失敗:キャッシュクリアして再試行 brew update brew cleanup brew reinstall openhuman # クラッシュ後の macOS クラッシュログ log show --predicate 'process == "OpenHuman"' --last 1h | tail -50 # Ollama は起動しているが OpenHuman から接続不可 curl -s http://127.0.0.1:11434/api/tags lsof -i :11434 # 完全アンインストール後に再インストール(brew 経路) brew uninstall openhuman rm -rf ~/Library/Application\ Support/*openhuman* 2>/dev/null brew install openhuman # 公式リポジトリ最新 Issue(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 デスクトップ開発 pnpm dev:app # Rust 側チェック cargo check -p openhuman --lib
FAQ
常時ネット必須? インストール、OAuth、クラウドモデルには必要。メモリファイルはローカル。Ollama なら弱い回線でも会話可だが、メール/カレンダー同期はネット必須。
無料? クライアントは OSS(GPL-3.0)。モデル API と一部コネクタは第三者課金の可能性あり。選んだプロバイダーの請求を参照。
Cursor Rules / Claude Code と競合? しません。OpenHuman はリポジトリを編集せず、コーディング Agent は Gmail を読みません。役割は分離。
- 製品解説— OpenHuman デジタルツインとは
- Skill トレンド— Agent Skill と GitHub トレンド
- 比較— OpenHuman vs OpenClaw
ZavCloud · クラウド Mac
ツインを 24 時間オンラインに?本物 macOS の常駐ノードを
Mac mini M4 専有インスタンス:ネイティブ macOS、固定 IPv4——OpenHuman バックグラウンド同期、Ollama、Xcode を同一台の監査可能マシンで。
プランと料金を見る