OpenHuman user guide
Install, grant permissions, connect OAuth, wait for the first sync, then run prompts. The steps below stack in order—skip one and the rest will feel broken.
Choose where to start
- Ship it fast
Jump into the numbered path—especially do not skip step 4 while waiting for sync.
- Privacy first
Read how data stays local first, then return to step 1.
Happy path
One beat per step. Step 4 is the usual "nothing works yet" moment — read it before opening a support thread.
- 1
Install the desktop app
Prefer the GUI installer when you can. If you use the one-liner, open the script once and read it before execution.
- 2
First launch
Grant OS permissions, complete sign-in, and touch Advanced RPC only when you self-host infrastructure.
- 3
Connect a data source
Wire Gmail, Slack, or another OAuth connector. Product sign-in does not replace per-service approval.
- 4~20 min
Wait for the first sync
Auto-fetch runs on a ~20 minute cadence. Until the first cycle finishes, briefing prompts such as "what did I miss?" can look empty—that is usually timing, not a broken model.
- 5
Run your first prompts
Once memory is warm, copy the briefing and cross-source examples from the First prompts page.
- 6Optional
Optional — explore the vault
Open the Obsidian-compatible vault from the Memory tab when you want to edit summaries manually.
Self-check before asking for help
Print-friendly (Ctrl+P). Checking these five items covers most beta triage threads.
- Installed from the official channel or reviewed the script before running it
- Accepted the OS prompts you actually need (voice, meetings, etc.)
- Finished sign-in and at least one OAuth connector
- Waited one auto-fetch cycle (~20 minutes) before judging briefings
- Ran an example prompt from First prompts
Still blocked? Troubleshooting index
Topic index
Jump here when you need a focused page—not the chronological walkthrough above.