Official Command

Read the shell script before you run it. If a signed DMG is available, use that — no terminal required.

bash

curl -fsSL https://raw.githubusercontent.com/tinyhumansai/openhuman/main/scripts/install.sh | bash

macOS Checklist

Recommended sequence for a clean macOS install. Each step includes what to check and what to do if it fails.

Step 1 — Download: go to tinyhumans.ai/openhuman and download the signed DMG for your architecture (Apple Silicon or Intel). If you use Homebrew, check if a cask is available.
Step 2 — Open the DMG: double-click it. If Gatekeeper warns you, right-click the app and choose Open, then verify the developer is TinyHumans.
Step 3 — Drag to Applications: move the OpenHuman app to your Applications folder. Do not run it from the DMG — permissions may not work correctly.
Step 4 — First launch: open from Applications. Grant Accessibility, Screen Recording, and Microphone permissions when prompted. These are required for full functionality.
Step 5 — Verify: open Settings and confirm the version matches your download. Check that the vault path is set before connecting any integrations.

Common macOS-specific issues and their fixes.

'App is damaged and cannot be opened': this is a Gatekeeper message. Right-click the app, choose Open, then click Open in the dialog.
M1/M2 Mac says the binary is for Intel: download the Apple Silicon build instead. The x64 build runs under Rosetta but may have performance issues.
Terminal script fails with 'command not found': the PATH may not include the install location. Add export PATH=$PATH:/usr/local/bin to your ~/.zshrc.
App launches but shows a blank window: this is usually a permissions issue. Go to System Settings > Privacy & Security > Accessibility and ensure OpenHuman is enabled.
Microphone does not work: check System Settings > Privacy & Security > Microphone and confirm OpenHuman is listed and enabled.

macOS hardware requirements and notes.

macOS 12 (Monterey) or later required. macOS 11 and earlier are not supported.
Apple Silicon (M1/M2/M3) or Intel x64. Apple Silicon Macs are the best local AI hosts due to unified memory.
Minimum 4 GB RAM. 8 GB recommended for light use. 16 GB+ if you plan to run local models via Ollama.
Apple Silicon advantage: unified memory lets you load larger local models than discrete-GPU setups with the same RAM.
Disk space: 2 GB minimum, 5-10 GB recommended if you sync large email or chat histories.

Confirm the installation succeeded before moving on to configuration.

Launch the app and check the version in Settings matches your download.
Set the Memory Tree vault path to a folder inside your home directory (not an external drive or network share).
Test the search panel to confirm the local index initialized.
Open one integration page (do not connect yet) and verify the OAuth URL is from the real service.
Check that Accessibility and Screen Recording permissions are granted in System Settings > Privacy & Security.

If you need to remove OpenHuman, follow these steps to clean up fully.

Drag the app from Applications to Trash.
Delete the vault folder manually if you want to remove all synced data. It is usually in ~/OpenHuman or the path you configured.
Revoke OAuth tokens at the source services (Google Account > Third-party apps, etc.).
Remove any PATH entries the installer added by editing ~/.zshrc or ~/.bash_profile.
Reinstalling later is safe — just repeat the install steps above.